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MACROTECH-—STILL THE S-100 
PERFORMANCE 
PACESETTER 


MI-286. Our 80286/Z80H Dual CPU Board is at least twice 
as fast as Compupro’s 8085/88 and it’s a direct replacement. 

The MI-286 has already become the standard by which other 80286 
based systems are measured. Ask us for a complimentary 
Benchmark Report. 


ADIT. There’s nothing else like it on the market. It’s an Intelligent |/O 
Board with its own real time firmware that lets you control up 
to 16 different terminals, modems or printers all from a 
single slot. ADIT is the performance standard in 
environments such as Alpha Micro where I/O 
speed is critical. 


V-RAM. High performance 
Static CMOS system mem- 
ory/ virtual disk in either 
quarter or half megabyte 
configurations. With its on- 
board battery and power-fail 
logic, the V- RAM sets a new per- 
formance standard at conventional 
static memory prices. When 
accessed through |/O port 
channels, the half megabyte 
V-RAM becomes M Drive 
compatible with true 
non-volatile solid- 

state disk 
Capability. 


MSR. High performance and 
reliability in a memory so fast 
you won't believe it’s a dynamic 
ram product. Compatible with all 
popular S-100 environments, the 
MSR’s low power consumption 
and 120 nanosecond ram 
devices set a new stan- 
dard for dynamic memory 
products. The MSR is avail- 
able in quarter, half, one 
and two megabyte configurations 
at the lowest prices in the industry. 


Dealers: 
Gifford Computer Systems (415) 895-0798 
Custom Computer Technology (800) 222-8686 


Priority One Electronics (800) 423-5922 MACROTECH International Corp. 
John D. Owens & Associates (212)448-6298 9551 Irondale Ave. 
In England; Fulcrum (Europe) Ltd. (0621) 828763 Chatsworth, CA 91311 


(800) 824-3181 «in Calif. (818) 700-1501 
Telex: 9109970653 


Macrotech dealers also include most Compupro Systems Centers, Heathkit 
Electronic Centers and Alpha Micro Dealers. 
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DUAL GPIB-488 INTERFACE 
BOARD 


A Stand-Alone, Independently Controlled 

| Channel |EEE-488 I/O Processor. |In- 

e Activity Modes for Controller-in- 

oller Assigned or Terminal 

Bus Slave, and all Interface Functions are 

handled transparent to Host System CPU 

through an on-board CPU and DMA con- 
troller. User Friendly operation. 


A&T, P/N 527498-800-102 


RGB COLOR GRAPHICS BOARD 


Programmable resolution up to 512 x 512 
pixels with 4 local video planes and on-board 
graphics processor. Color mapper allows 16 
colors from a palette of 4096. Light pen 
input. Plus more ... 


A&T, P/N 527498-300-101 
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Valencia, 


12-BIT A-D-A CONVERTER 
BOARD 


8 Channel A-D: 12 microsec. Conversion, 
50KHz Sample Rate, Programmable 
Gains, Offset and Diff./Single Modes. 

8 Channel D-A: 2 microsec. Settling, 
Bipolar V or Unipolar | Output. Program- 
mable Reference levels, Dual-Ported Chan- 
nel Refresh RAM. 16/8-Bit Data 
Transfers via |/O or Memory Mapped 


A&T, P/N 52748-900-101 
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BAR CODE PROCESSOR BOARD 


The BarTender is a stand-alone I/O Pro- 
cessor that reads and prints most common 
Bar Codes. Includes bi-directional reading, 
wand interface, clock/calendar with battery. 
Extensive documentation and software. 


A&T,52748-500-101 Without Wand 
A&T,52748-500-201 With Wand 
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PERIPHERAL SUPPORT 
BOARD 

Two Serial SYNC/ASYNC Ports with 
RS-232, TTL or Current Loop Outputs, 
three 8-Bit Parallel Ports, three Timers, 
Real Time Clock/Calendar and Response 
Programmable Interrupt Controller. Small 
Proto Area with +5 and +1ev. 


AST, P/N 52748-150-101 


MULTI-PURPOSE 
PROTOTYPING KIT 

Industrial Quality with Plated-Thru holes for 
Wire-Wrap or Solder projects. Complete 
with +5, +12@v Regulators, Bus Bar, Filter 
Capacitors, and Manual. 


P/N 52748-450 


‘(8/64Kx16 STATIC RAM MODULE 


OARD, SMART PROTOTYPING KIT, 


CIRCLE 10 ON READER SERVICE CARD 


ALSO AVAILABLE: 
SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE. 


iN a 4 | , = | 4 y . 


One Success After Another. 


Since 1968 Teletek has been a leader in the design and 
manufacture of single board computers, controllers, 
memory boards and interface boards. 

Teletek offers five distinct single board computers 
(SBCs), each with its own unique features, to meet the 
varied needs of the system integrator. Based on the 
8086 16-bit and Z80 8-bit microprocessors, Teletek’s SBCs 


LUN es 


eee eens 


SBC-II 


HD/CTC 


In Europe: 
Kode Limited 
Station Road 
Calne, Wiltshire 
SN11 OJR England 
tel: 0249-813771 
telex: 449335 


In Brazil: 

DANVIC S.A. N 

R. Conselheiro 3 
Nebias, 1409 5 

01203 Sao Paulo, Brazil & 

tel: 221-6033 (PABX) 

telex: 1123888 CICP BR 


Teletek provides a 30 day evaluation 
program to qualified customers. For 
more information, call our Sales Depart- 
ment at 916-920-4600 or write for our 
information package. 


Sacramento, CA 95638 
916-920-4600 


Systemaster II (128K, 6/8 MHz) 


© 1984 Teletek 
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will run at 4, 5, 6, or 8MHz and are available with up to 
512K of onboard dynamic RAM. The SBC 86/87 also offers 
an optional 8087 math coprocessor for numeric intensive 
applications. 

Teletek’s Systemaster II provides two RS232C serial 
ports and two Centronics-compatible parallel ports or 
may be optionally configured to provide a SCSI interface 
or an IEEE-488 interface to support many laboratory 
testing and measuring instruments. 

Teletek also offers a dual controller board, the HD/ 
CTC, which will control any two ST506-compatible hard 
disk drives and any QIC-02/QIC-24-compatible 
cartridge tape drive. This unique design saves 
hardware cost as well as space in the mainframe. 

Teletek’s IEEE 696/S-100 boards run under 
the multi-user, multi-processing operating 
system TurboDOS by Software 2000, support- 
ing up to 16 users and 
capable of running PC-DOS 
application programs. For 
single-user systems, Teletek 
is supported by the CP/M 
operating system. 
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I would like to take a moment out of 
a very hectic day to applaud all the 
Micro/Systems Journal subscribers. 

For weeks now I have personally 
processed thousands of subscriptions 
and have felt the pleasure, excitement 
and warmth that comes from reading 
your comments. Almost every sub- 
scription contained a comment! 

You've expressed hopes, en- 
couragement, and ideas for the future 
of Micro/Systems Journal. Almost 
everyone wants to be part of it. 

I would like to extend a special 
‘thank you’’ to those who refused to 
take either of the discounts offered and 
to those who gave even more than the 
un-discounted rate, because they 
wanted so much to help to get this 
magazine off and running. They felt 
that this was the least they could do to 
lend their support. 

And, there are those.... many, 
many of you.... who are receiving 
magazines from Ziff-Davis you never 
ordered and even now don’t want. You 
wrote about it in anger and frustration. I 
wish we could help, but most of you 
realize that we have no connection with 
the former publishers of Microsystems 
magazine. I wrote to many of you sug- 
gesting what you might do to get a 
refund. What I suggested was based on 
the experiences of those who had 
already succeeded in getting that re- 
fund. Many felt a touch of triumph as 
they traded in their Ziff-Davis ‘‘re- 
fund’’ check for a Micro/Systems 
Journal subscription. 

So, our home has again become a 
publishing house.... our basement a 
stockroom and mailroom.... and, our 
ping-pong table once again a produc- 
tion area. The Post Office and U.P.S 
have dedicated a driver and truck to the 
cause. 

But, if lever wonder ‘‘why did I do 
it again?’’, all I have to do is look at Sol 
(if I can find him) and read some more 
subscriber comments. 

I guess, like Sol, we’re all crazy. 

Lennie Libes, Co-Publisher 


..and, from the Editor 


It is with deep regret that I report to 
you that Ziff-Davis has done it 
again..... they have closed up yet 
another magazine. COMPUTERS & 
ELECTRONICS magazine ceased 
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publication with the April issue. We all 
remember when C&E was called 
POPULAR ELECTRONICS. And, in 
particular we remember the January 
1975 issue that carried the article on 
how to build the Altair Computer, the 
first S-100 system. PE was a pioneering 
magazine dedicated to the electronics 
hobbyist. Les Solomon, the technical 
editor, and authors, such as Forest 
Mims, made it a consistently worth- 
while publication. I was a loyal sub- 
scriber for over 30 years. And, during 
its last year and a half wrote a regular 
column for them. 

Ziff-Davis has now closed about a 
half dozen computer magazines, leav- 
ing itself only six. One wonders which 
one will be next. 

C&E had a circulation of close to 
600,000; the highest in the computer 
magazine biz. When it was PE, it had a 
circulation of about 400,000 and was 
clearly dedicated to electronic hob- 
byists. But when Z-D refocused the 
magazine to the computer field, it lost 
loyal readership (replacing it with ex- 
pensive transient readers) and lost 
advertisers (who could no longer afford 
the highest ad rate in the industry and 
were not sure of readership interests). 
Z-D could have admitted its mistake 
and changed the magazine back to its 
original focus, reduced its circulation 
and ad rates and moved it back into the 
black. Regretfully Z-D decided to take 
the easy way out and close up a maga- 
zine that had a large devoted following. 

One wonders..... which magazine 
will former C&E subscribers now find 
in their mailboxes? 


We have received well over 2,500 
personal letters from subscribers 
wishing us well and offering sugges- 
tions as to the future direction of this 
magazine. We wish we had the room to 
publish them all, but they would have 
taken up this entire issue and maybe 
more. Rather, we have selected a few 
representative letters and messages and 
you will find them in the following 
“‘Letters’’ section. 

We read every letter we receive and 
take them to heart, so keep the letters 
coming. 


Micro/Systems Journal Software in 
Public Domain 


All of the software listings pub- 
lished in Micro/Systems Journal has 
been placed into the public domain. 
Thus, CP/M software listings will be 
found in the SIG/M public domain soft- 
ware library and MS/DOS software 
listings will be found in the PC/Blue 
public domain software library. I there- 
fore suggest contacting your local com- 
puter club to obtain machine readable 
copies. 

If you have problems obtaining any 
of this software thru public domain 
channels then you may obtain copies 
directly from us. To do this send a note 
indicating the software desired and the 
disk format together with a check for 
$10 ($15 outside of North America). 
Mail to: Microsystems Journal, Box 
1192, Mountainside NJ 07092. 

Sol Libes 
Editor & Co-Publisher 
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You can stillbuy _ 
quality and dependability 
at a reasonable price. 


That’s exactly what we drive home at Viasyn. We offer you a whole line 
of CompuPro® IEEE 696/S-100 Bus boards. Along with single- and multi-user 
systems compatible with over 3,000 standard business applications, plus a wide 
variety of scientific and industrial programs. Each one’s a value our competition 
finds hard to beat. 

You can choose from a broad range of CPU boards, memory boards, disk 
controllers, network and interface boards, plus PC Video, in color or black and 
white. You can mix or match 8-bit and 16-bit software on the same machine or 
on different machines. And pick just the power and memory you need. Object: 
to grow and multiply in capabilities, at optimum cost efficiencies. Without sacri- 


ficing quality or dependability. ™ 
If that’s what you’re driving for, write us for our new 
short-form catalog or simply call our toll-free number. 


The CompuPro People 


Where Computers Grow 


3506 Breakwater Court, Hayward, CA 94545 
Call 800/VIASYN-1. In CA, 800/VIASYN-2. TWX: 510-100-3288 VIASYN CORP 


CompuPro is a registered trademark of Viasyn Corporation. 


, \EeaESESee FEBRUARY 5, 199 
' i | | SESE == VOL 2 NO. 5 $2.99 
4 ashton-Tate Pulls ‘Multi-User dBASE I’ 
4\ From US., Canada Because of Poor Sales 


CULVER CITY, CA—Poor The move appears to be a blow 
sales have forced Ashton-Tate to to 3Com, makers of the only net- 
discontinue the multiuser version work on which M ulti- User 
of dBASE IJ in the United States dBASE II now runs. The Ashton- 
and Canada, according to 4 com- | Tate spokesman $ comments 
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pany spokesman. seemed clearly to indicate that 
Theo Multi-User dBASE III, due this 
enring, Will not run on the ve 
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DATAFLEX 
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DATA 
8525 SW 129 Terrace, Miami FLA3iS6- 6565 ( 
Telex 469021 © FL 33156-6565 (305 
Compatible with MSDOS, PC-DOS 1 DATA ACCESS Cl ) 238-0012 
MSDO M ee _ CP/M, CP’M- 
S is a trademark of Microsoft eM and le Madea Beene Chinen aie. Novell Sh 
, Ma ' IBM PC: arenet, PC- 
re monn of Digital tll iho and OSM “ein Molecular N-Star, 
is a trademark of pens x and FlexKeys are t 
Tate rademarks of Data A\ 
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Quality 


3-100 Products 


FULCRUM: The S-100 Specialists 


Introducing... 
FULCRUM’S NEW 


MPUZ CPU 


This NEW MPUZ 
CPU utilizes the Z-80 
8MHz uPas a basis for 
its 8MHz CPU for S-100 
systems, and has been 


carefully designed to meet the requirements of the IEEE - 
696 standard. The quality and performance this CPU pro- 
vides is rarely found in S-100 products, and you can see 


why...only $349. 


> 4 or 8MHz clock rate 

> Two RS-232 serial ports 

> Centronics printer ports 

> Real time clock with bat- 
tery back-up 

> Vectored interrups to any 
block location in memory 

> Programmable timer 

> ROM monitor 


> 
> 
> 
> 


Power on Jump 

On board wait states 

2K of RAM space 

24-bit extended 
addressing 

Latched Status 

Front panel compatibility 
MPM support 


Best Value 


In 


Disk Controllers... 


OMNIDISK 


Now the FULCRUM 
OMNIDISK offers S-100 
systems users a unique 
marriage of component 
compatability and 


technological innovation. These together follies ies 
not found in any conventional disk controllers made today. 
See for yourself what tomorrow looks like...only $349. 


> Simultaneous support of 
both 5%” and 8” floppy 
disks and hard disks 

> Complete 24 bit DMA 

> Power on boot for 5%” 
and 8’ floppy and hard 
disks 

> Power on boot PROM 

> On board de-blocking to 
save RAM space over 
BIOS 


> Interfaces with the WD 
1001°hard disk controller 

> Supports 13 devices 
simulatneously 

> Full track buffer allows 
controller to recall entire 
track 

> DMA’S at 10 MHz 

> Supports MS DOS 

> 10K on board buffer 
saves two K of TPA 


So before you buy another S-100 component, call or write for 
our FREE catalog. And see how your system can benefit from 
oon the FULCRUM difference ..—.jV"egqeee 


“CP/M *2.2 configured for OMNIDISK 
$60. *Trade mark of Digital Research. 
FREE U.P.S. ground shipping on 
prepaid orders. Shipping is added to 
VISA, M/C, and C.O.D. orders. CA 
residents, please add sales tax. 
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707/433-0202 459 Allan Court, Healdsburg, CA 95448, 


Also in FULCRUM'’S Family: OMNIRAM 
64K memory board. Serial I/O 2-2 & 
Video I/O Interface boards, Relay 
board, |-8080, 8015 and 8035 main 
frames with 21 slot mother boards, 
DPA front panel and A/D board. 


News, 


Random Rumors & Gossip 

Look for Borland to shortly intro- 
duce version 3.0 of Turbo Pascal, with- 
out a doubt the most popular micro ver- 
sion of Pascal. Improvements include 
much faster compile time, faster execu- 
tion of compiled code, turtle graphics, 
and new file I/O system. Also rumored 
coming from Borland later this year are 
versions of C, Modula-II, and a spread- 
sheet to compete with Lotus 1-2-3 ...... 
Microsoft is expected to shortly 
announce Version 4 of MSDOS which 
will, among other things, add a Virtual 
Memory system to the AT. Expect 
Microsoft to include a plug-in card to 
provide the VM hardware support. 

I hear that a manufacturer (name- 
less at this point) plans to introduce a 
low-cost Z80-based system with 
ZCPR3 and the ZDOS operating sys- 
tem instead of CP/M-80....... and 
Spectravideo, Fremont CA, is rumored 
about to introduce a CP/M-80-based 
portable, with 3.5’’ floppy drive and 25 
line x 80 character LCD display for 
well under $1,000..... and Viasyn 
(formerly CompuPro, nee Godbout 
Electronics) is expected, this fall, to 
release a version of UNIX for its 16032 
CPU card. 

IBM has signed a contract with 
MiniScribe for 20Mbyte, 3.5’’ hard 
disk drives. Now which new product 
could this be for? And there are rumors 
of a System 36 version of the AT com- 
ing with a link to the IBM PC network. 
Also known to be in the works is a laser 
printer capable of 20 pages per minute. 

There are reports that 256K and 
64K RAM chips are already selling for 
$4 and 80 cents, respectively, on the 
large volume spot market. Last 
December, 256K chips were over $8. 
Predictions are that prices will fall even 
further this year..... Texas 
Instruments, Compaq and several other 
manufacturers are expected to shortly 
introduce AT-clones. Looks like the 
AT bus, hardware and operating sys- 
tem may become a defacto standard for 
80286-based systems. 


MS-DOS on S-100 Systems 

More and more S-100 users are up- 
grading their systems into the 16-bit 
world with 8088, 8086, 80186 and 


Views & 


by Sol Libes 


80286 CPUs in their systems. Most of 
these users would like to use the MS/ 
DOS operating system instead of CP/ 
M-86, mainly because of the large soft- 
ware base in existence for MS-DOS. 
However, there is a problem here. One 
can buy a copy of MS-DOS for the 
IBM-PC and implementations for most 
of the PC clones. However, because of 
hardware differences they will not even 
boot. 

Computer House, Woodacre CA, 
some time ago developed a version for 
CompuPro systems. Now, many of the 
S-100 manufacturers are tailoring their 
hardware systems to support standard 
PC-DOS. For example, Tarbell 
Electronics, Carson CA has introduced 
a new 80286-based CPU card that will 
boot up a standard IBM-PC DOS disk 
without any modifications required. 
And, if the system contains a PC- 
compatible video card (Lomas Data 
already has such an S-100 card and 
Viasyn is expected to start shipping 
theirs soon) then one can run things like 
Lotus 1-2-3 with lightening speed. 
Even without the video card programs 
such as WordStar, Multiplan and 
dbase-II can be run. Further, there is a 
great likelihood that these systems will 
be able to boot and run other operating 
systems written for the PC and AT (e.g. 
XENIX and PICK). 

Companies such as Lomas Data and 
Seattle Computer Products already sell 
versions of MS-DOS to run with their 
hardware. And, if there is a reader who 
would like to write an article on how to 
modify PC-DOS to run with S-100 16- 
bit CPUs whose manufacturers do not 
supply MS-DOS please contact me. 
We are looking to publish such an 
article. 


PC-Il Where Are You? 

Speculation is that IBM has held 
back introducing the new version of the 
PC because they have warehouses full 
of PCs and XTs which are moving very 
slowly. Only when inventory is cleared 
out is IBM expected to release the PC- 
Il. The most important feature of the 
PC-II is expected to be its design for 
high volume automated mass produc- 
tion to reduce production costs. 

The unit is expected to use the 
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80186 or 80286 microprocessor with 
restricted performance (e.g. less mem- 
ory addressing capability) so as not to 
impact sales of the AT. Further, IBM is 
expected to retain the 5.25’’ disk for- 
mat and offer a 3.5’’ drive as an option. 
IBM has done extensive market re- 
search and concluded that its cutomers, 
with well over 3 million PCs already in 
use, would be very upset if IBM aban- 
doned the 5’’ drive. Hence, IBM is 
expected to provide a bridge to the 
3.5°’, 1.6Mbyte drive, which they are 
expected to use in their new portable 
(expected this summer) and other new 
systems coming later this year and 
next. IBM would like to get the desk 
footprint of their new machine to be 
significantly smaller than that of the 
PC 


In the meantime, IBM will halt pro- 
duction of the PCjr, only 16 months 
after it was introduced. It marks IBM’s 
most visible failure in the personal 
computer marketplace. Actually this is 
IBM’s third failure in the personal com- 
puter marketplace as the two predeces- 
sors to the PC (the 5100 and 5110) also 
flopped and IBM has not done too well 
with the PC-portable. However, their 
success with the PC and AT have much 
more than compensated for their 
bombs. Also, the XT (particularly 
since the introduction of the AT) has 
been a poor sales performer. 

IBM invested close to $50 million 
promoting the PCjr and cut the price 
drastically for the Christmas selling 
season, but since the first of the year 
sales have been nil as IBM restored the 
regular price for the machine. Earlier 
IBM replaced several thousand 
keyboards when reviewers, dealers and 
customers complained. In all, IBM 
sold about 270,000 jrs last year, with 
75% of the systems sold in the last 
quarter when the complete systems 
price dropped to under $1000 list, with 
a street price between $800-900, in- 
cluding a color monitor and software. 
IBM’s abandonment, leaves Apple, 
Sanyo, Atari and Commodore as the 
major competitors in the home compu- 
ter market. However, Sinclair and 
several Japanese and far east suppliers 
are expected to cautiously enter the 
chaotic U.S. market this year. Sanyo, 
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who introduced an MS-DOS machine 
with limited PC capability, has over the 
last two years established a strong deal- 
er network and a large and loyal user 
base. Recently, they improved the PC- 
compatibility of the machine and its 
performance. The price for a basic sys- 
tem is well under $1,000 and is heavily 
discounted by most dealers, making it 
very attractive as a home system. 


The Check Is in the Mail 

Imagine a microcomputer manu- 
facturer shipping $6 million in mer- 
chandise to a retailer and not being 
paid. If it had happened to most any 
other manufacturer it probably would 
have forced the company into bank- 
ruptcy. But not IBM... it takes it in 
stride. 

IBM filed suit against Computer- 
mate, a California computer retailer, to 
which it shipped 400 XTs and other 
stuff totalling $6 million. The retailer 
sent IBM a check which bounced and 
then a second check which also 
bounced. Finally, IBM filed suit 
against the retailer. 


Newsletters of Note 

**null-Babel/CBNnews’”’ is a news- 
letter for CBasic users. Published 
monthly a subscription is $18/yr US 
and Canada and $28/yr foreign. Write 
to: Ric Allan, Box 40690, Cincinnati 
OH 45240, or call: (513)851-4774, 
after 7PM EST. 

**Z-NEWS”’ is a monthly newslet- 
ter supporting users of ZCPR3 and the 
new ZDOS disk operating system. It is 
published by Echelon Inc., 101 First 
Street, Los Altos CA 94022, telephone 
(415)948-3820. Echelon also supports 
a bulletin board system for ZCPR3 and 
ZDOS users. Called **Z-Node’”’ it is at 
(415)489-9005. 


Public Domain Software News 

The C User’s Group’s public do- 
main C software library now consists of 
44 volumes of software which are 
available in 69 different 5’’ and 8”’ disk 
formats. The group also publishes an 
infrequent newsletter. For information 
on the software library and newsletter 
write to: The C User’s Group, 415 E 
Euclid, Box 97, McPherson KS 67460 
or cal! (316)241-1065. 


Random Bits 

Bill Gates, Microsoft Corp. chair- 
man, announced at a recent indepen- 
dent software vendor gathering that 
they are projecting that over 400,000 
copies of Xenix/286 will be sold. If this 
comes to pass Xenix will be the most 
popular operating system for small 
multi-user computer systems and could 
become the defacto standard for UNIX. 


CP/M-80 C Programmers ... 


Seve time 


... With the BDS C Compiler. Compile, link 
and execute faster than you ever thought 
possible! 


If you’re a C language 
programmer whose patience is 
wearing thin, who wants to spend 
your valuable time programming 
instead of twiddling your thumbs 
waiting for slow compilers, who 
just wants to work fast, then it’s 
time you programmed with the 
BDS C Compiler. 

BDS C is designed for 
CP/M-80 and provides users with 
quick, clean software 
development with emphasis on 
systems programming. BDS C 
features include: 


Ultra-fast compilation, linkage and 
execution that produce directly 
executable 8080/Z80 CP/M command 
files. 
A comprehensive debugger that 
traces program execution and 
interactively displays both local and 
external variables by name and 
proper type. 
Dynamic overlays that allow for run- 
time segmentation of programs too 
large to fit into memory. 

e A 120-function library written in both 
C and assembly language with full 
source code. 


Plus... 

e A thorough, easy-to-read, 181-page 
user's manual complete with 
tutorials, hints, error messages and 
an easy-to-use index — it’s the 
perfect manual for the beginner and 
the seasoned professional. 

An attractive selection of sample 
programs, including MODEM- 
compatible telecommunications, 
CP/M system utilities, games and 
more. 

A nationwide BDS C User's Group 
($10 membership fee — application 
included with package) that offers a 
newsletter, BDS C updates and 
access to public domain C utilities. 


BDS C is designed for use with CP/M-80 


operating systems, version 2.2. or higher. It is 


not currently available for CP/M-86 or MS- 
DOS. 


Reviewers everywhere have 
praised BDS C for its elegant 
operation and optimal use of 
CP/M resources. Above all, BDS C 
has been hailed for it’s remarkable 
speed. 


“T recommend both the 
language and the implementation 
by BDS very highly.” 

Tim Pugh, Jr. 
in Infoworld 


“Performance: Excellent. 
Documentation: Excellent. 
Ease of Use: Excellent.” 
InfoWorld 
Software Report Card 


“|. a superior buy...” 
Van Court Hare 
in Lifelines/The Software 
Magazine 


BYTE Magazine placed BDS 
C ahead of all other 8080/Z80 C 
compilers tested for fastest 
Object-code execution with all 
available speed-up options in use. 
In addition, BDS C’s speed of 
compilation was almost twice as 
fast as its closet competitor 
(benchmark for this test was the 
Sieve of Eratosthenes). 


Don’t waste another minute on 
a slow language processor. Order 
your BDS C Compiler today! 


Complete Package (two 8” SSDD disks, 
181-page manual): $150 

Free shipping on prepaid orders inside 
USA. 

VISA/MC, COD’s, rush orders accepted. 
Call for information on other disk 
formats. 


are, Inc. 


BD Software, Inc. 
P.O. Box 2368 
Cambridge, MA 02238 


(617) 576-3828 


Dear Sol: 

I must be crazy too! Sign me up for 
two years. Enclosed is the Ziff-Davis 
check that I received as a refund on my 
old Microsystems subscription. I have 
endorsed it over to Micro/Systems 
Journal. 

I had a bit of a hassle getting the 
refund. I got my refund by writing to: 
Shane G. Boel, Circulation Manager, 
PC Tech Journal, Box 2968, Boulder 
CO 80322. I told him that I did not want 
a magazine | did not subscribe to and 
wanted a refund on the remaining por- 
tion of by sub. I had to wait about three 
months but they finally came through. 

Good Luck. 

David Robinson 
Bismark North Dakota 


Dear Sol: 
I have the following suggestions: 
a) Aim at the frontiers... Z8000, 
National 32016/32032 and Intel 80286/ 
386. Urge the promotion of a standard 
for 32-bit processors on the S-100 bus. 
b) All code for MS-DOS and CP/ 
M-86 should be generic... should 
only use standard system calls and not 
depend on IBM-PC hardware. 
c) I suggest that Turbo Pascal code 
be the standard. 
Robert Hanrahan 
Gainsville Florida 


Dear Sol: 

Thank you so much for doing it 
again. Of the many computer maga- 
zines I have subscribed to over the 
years, Microsystems was my favorite. 
Keep the good stuff coming on CP/M, 
C, UNIX and the hell with IBM. 

Ed Roberg Jr 
Clearlake CA 


Folks, 

Please enter me as a subscriber to 
Micro/Systems Journal. Delighted to 
hear it exists. This time... PLEASE, 
PLEASE, PROMISE... not to sell it 
to the City Slickers, ok? 

Dave Cortesi 
Palo Alto CA 


Sol: 

I was a subscriber to Microsystems 
from Vol 1, No 1. I would like to sub- 
scribe to your new magazine, however 
Ziff-Davis has not yet refunded by 
money, even after several letters. 
When they do I will probably sub- 
scribe. 
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I owned one of the first computer 
stores so really have been active for a 
while and enjoyed Microsystems! 
Looks like the New York ‘‘bean coun- 
ters’’ got to you. 

Good luck! 

Chuck Suit 
Silver Spring Maryland 


Sol: 

Don’t enter my subscription! 

I do not want to start another sub- 
scription and have it turned into a 
worthless magazine! 

Forrest | Gompf 
San Diego California 


Dear Sol: 

Although I still use CP/M I have a 
Zenith 160 PC compatible and so 
would like to see PC compatible arti- 
cles also... especially on MS/DOS, 
PC/Blue and C-User Group. 

Cole Ellsworth 
Garden Grove California 


Dear Mr. Libes: 
I was very much disappointed when 
I was informed by Ziff-Davis that 
Microsystems ceased publication. My 
‘*first’’ subscribed issue of 
Microsystems happened to be the 
“‘last’’ issue. I was very resentful when 
I was offered an IBM oriented maga- 
zine in lieu of my sub to Microsystems. 
I am glad that you and your wife are 
back to keep us hackers happy. The 
best feature of ‘‘Microsystems’’ has 
been, to me, that it has managed to keep 
its eyes to the future computer trends, 
satisfying at the same time hackers’ 
need to work with micros they have 
now. This unique blend of helping us 
with micros we have and also assisting 
us to see what’s in the future will be 
found in your new journal, I hope! Wel- 
come back among the hackers who 

need you. 

Paul Naitoh 
San Diego California 


Dear Sol: 

Welcome back! My life ‘‘also’’ 
doesn’t seem the same without you and 
Microsystems for evening comfort and 
knowledge expansion. Even though 
there is a plethora of computer maga- 
zines on the racks, your new magazine 
is needed. 

I have a problem and would 
appreciate some help from you readers. 


Letters to M/S-J 

We welcome your letters with com- 
ments, compliments, criticism and sug- 
gestions. We read them all and publish 
the most noteworthy, even if they are 
critical of us. We do not have the staff 
to answer all letters personally. And all 
letters become the property of M/S-J 
and may be subject to editing. Further, 
we do not print letters that do not in- 
clude a name and address. 

Please send your letters to: Micro/ 
Systems Journal, Box 1192, 
Mountainside NJ 07092. 
ee eee 


I am a one-man company specializing 
in the construction of vertical software 
for CP/M, MS-DOS and VAX/VMS 
software. Currently, I am in a bit of 
bind moving a program from CP/M to 
MS-DOS. My system consists of in- 
teracting programs written in Digital 
Research’s CB80 which I can also com- 
pile under CB86. I have an S-100 sys- 
tem from U.S. Micro Sales, made by 
XOR Data Systems, which has two 8”’ 
DSDD drives and a controller which 
handles both 8’’ and 5-1/4’’ drives. I 
want to know is it possible to format 
and copy to MS-DOS 5-1/4’’ disks 
from my 8’’ drives while working 
under CP/M? 
Melvin W Smith, 
SYNTEL Data Systems Ltd 
Ste. #1111, 
10080 Jasper Ave 
Edmonton, Alberta, 
Canada T5J 1V9 
Whenever I want to move files be- 
tween systems with incompatible disk 
formats I will either use a null modem 
interface between the two systems and a 
data transfer or communications pro- 
gram to move the data. On occasion I 
have even uploaded the file from one 
system to the other via modem and the 
telephone line. This works very nicely 
for Basic and ASCII files. 


Dear Mr. Libes 

I want to wish you well in your new 
endeavor and to tell you that the micro 
world will get along just fine without 
the old Microsystems. Let me tell you 
why I will not be subscribing. I think 
you are living in the past. Way too 
much stuff on CP/M, S-100 bus and 
such. I have been in the PC/MS-DOS 
camp for 2 years now and am very glad 
I swore off (and at!) CP/M. You might 
be able to fool some potential subscri- 
bers into thinking you can teach an old 
dog new tricks, but not me. 

If the early issues indicate that I am 
wrong and contain numerous current 
original articles on and about non-CP/ 
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M systems, I will admit I am wrong. 
Wandal W Winn 
Anchorage Alaska 


Dear Sol: 
Are there going to be any MS-DOS/ 
S-100 articles? 
Tony Price 
Burbank California 


Sirs: 

I would very much like to see an 
article or two addressing the CompuPro 
8/16 hardware and software. I am also 
interested in the Macrotech MI-285 Z- 
80H/80286 CPU replacement for the 
Godbout one. Are there any pitfalls or 
contraints? Will an S-100 color video 
board be available to run PC graphics? 
Will the newly released DRI Concur- 
rent-DOS run with the Macrotech 
CPU? 

Dan Nelson 
Phoenix Arizona 


We expect to be addressing these 
questions in articles now being written. 


Sol: 
Glad to see you back. The last issue 
was the best. Hope you can keep it up. 
R. C. Howard 


Dear Sol: 
Are you going to continue to write 
for Micro-Cornucopia? 
M. H. Noble 
Pawcatuck CT 


Micro-Cornucopia is a fine maga- 
zine and I tried to interest Dave Thomp- 
son, the publisher, in publishing this 
magazine with me as editor. Actually, I 
tried to interest several publishers with 
no luck and hence I am back in the 
magazine publishing biz again when all 
I wanted was to be an editor. 

Micro/Systems Journal is taking up 
all my time and forced me to drop all of 
my other projects including writing for 
Micro-C. 


Sol: 

Best of luck to a first class masoch- 
ist! You deserve the best but probably 
won’t get it. Ziff-Davis will probably 
make life miserable for you the way 
IBM does to small companies. Long 
live the underdog! 

Art Hurst 
Woodland Hills CA 


Dear Sol: 

... hope you will include articles 
on C programming language as well as 
the UNIX operating system. 

Charles D’Englere 
Decatur GA 


Dear Sol: 

I ought to be mad at you, but I 
cannot hold a grudge. I had cancelled 
all my subscriptions to computer maga- 
zines except yours. Then you sold out 
to Ziff-Davis and they closed 
Microsystems. I was sorry to see you 
old timers pass from the scene. 

Then I got your letter and I was 
really excited about something good to 
read again. I wish you all the luck... 
you will need it to make it. 

J. E. Murray 
Columbia SC 


We did not sell out to Ziff-Davis. 


We sold the magazine to Dave Ahl of 


Creative Computing. When Z-D bought 
the CC operation they got their hands 
on Microsystems. 

The former President of the Z-D 
computer magazine group supported 
Microsystems and tried to help it grow. 
He allowed me to hire Chris Terry as 
technical editor and to go monthly. 
Many of our best issues were done dur- 
ing this period. When he was fired the 
new President took one look at the bot- 
tom line dollars and decided that, 
although Microsystems was profitable, 
more money could be made by investing 
in other areas. 


LATTICE WORKS 


LATTICE, INC. OFFERS 
C COMPILERS 


The industry’s standard C com- 
piler, Lattice C, is now published 
directly by Lattice. You can obtain 
editions of Lattice C from other pub- 
lishers, but when you purchase our 
edition, you get support directly 
from the people who wrote the C 
compiler. And when you register 
your purchase with Lattice, you are 
notified of all updates and enhance- 
ments. You will also be notified of 
the new C programming tools as they 
become available from Lattice. 


When you are ready to purchase a 
C compiler, consider the source. 
Then call Lattice, Inc. 


LATTICE OFFERS C 
COMPILER UPGRADES TO 
MICROSOFT USERS 


Lattice announces the opportunity for 
users of the Microsoft MS-DOS C com- 
piler to upgrade to the standard Lattice 
C and obtain a free copy of Lattice’s new 
C-SPRITE symbolic program debugger. 


According to Dave Schmitt, Lattice, 
Inc. President, ‘“‘Until recently, the 
Microsoft C compiler was an early ver- 
sion of our compiler. Now that Microsoft 
has switched to their own compiler, we 
feel that purchasers of the earlier prod- 
uct deserve a low-cost way to remain 
compatible with the latest Lattice tech- 
nology and the extensive third-party 
support for the Lattice product.” 


The upgrade kit costs $150 and 
includes Version 8.20 of the Lattice C 
compiler with its new two-color, typeset 
manual and the C-SPRITE program 
debugger. (The regular retail prices are 
$500 for the compiler and $175 for 
C-SPRITE.) 


This offer to Microsoft C users expires 
July 31. Upgrade orders must be accom- 
panied by the original Microsoft 
diskettes. 


LATTICE C USERS’ 
GROUP FORMED 


An independent Lattice C Users’ 
Group has recently been formed, and is 
headed by Bill Hunt, author of the book, 
The C Toolbox. The group will serve 
users of Lattice C, but membership is 
open to any C compiler users. 


Members will receive a bi-monthly 
newsletter explaining C features and 
providing examples of their use, explor- 
ing new ways to use Lattice C, and will 
include a question and answer column. 
The newsletter will be supplemented by 
a disk containing source files, demo 
programs and library functions, and 
the best of the public domain C pro- 
grams. 


Lattice, Inc. will provide complete 
support for the new users’ group by 
sharing new plans, discovered bugs, 
and ‘‘tech”’ tips. 


Register your C compiler now to 
receive complete information on joining 
the Lattice C Users’ Group. 


ASK ABOUT OUR “TRADE 
UP TO LATTICE C POLICY” 


After purchase, return registration cards 
for free subscription to the ‘Lattice 
Works” newsletter and important infor- 
mation about the Lattice Users Group. 


— 
Lattice, Inc. 
P.O. Box 3072 
Glen Ellyn, IL 60138 
(312) 858-7950 
TWX 910-291-2190 
== 


International Sales Offices 

Belgium: Softshop. Phone: (32) 53-664875. 
England: Round Hills. Phone: (0672) 54675. 
dapan: Lifeboat Japan. Phone: (03) 293-2311. 


Some months back SIG/M received 
a proposed contribution of a disk called 
Death. A battle with aliens from outer 
space? A duel to the end of the knights 
of old? No, it was a checklist of things 
to do before the inevitable happened! 


The author had put a lot of time and 
effort into writing it. Some parts made 
sense, and some of it could have caused 
problems if one did not consult with an 
attorney. It would not have been 
acceptable for the library in any event. 
However, what killed ‘‘Death’’ was the 
fact that the author requested the user 
send him a small contribution. Death 
might be inevitable, but our author felt 
it should not be free. 

In talking to the authors and propo- 
nents of Freeware or Shareware one is 
told that they cannot afford to market 
the program. They want to use the 
worldwide facilities of the public do- 
main distribution network for nothing 
— and then they write us nasty letters 
when we say no! When you write the 
Great American novel and the pub- 
lishers turn you down, your choice is 
either vanity press or forget it. How 
many commercials does CBS air for 
nothing because the sponsor can’t pay? 
The Borland people have clearly de- 
monstrated how a good product at a 
reasonable price will sell, even when 
marketed on a shoe string budget. The 
Freeware backers contend that since the 
option to pay or not is the users, it is 
beneficial to the users to distribute it in 
the public domain network. Talk to 
them and they will tell you that without 
distribution on the bulletin boards and 
in the public domain libraries, the au- 
thors would not produce these works. If 
any of you have been to downtown 
New York lately during a weekday 
lunch hour, you know that you can 
barely walk on the sidewalk because of 
all the street peddlers. The street ped- 
dlers are taking business from legiti- 
mate stores. The stores pay taxes, are 
around when you need to exchange 
something, etc. Same thing with some 
of the Freeware peddlers. A small ad in 
Computer Shopper or one of the maga- 
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In the SIG/M 
Public Domain 


by Stephen M. Leon 


zines should not be too much of a bur- 
den. To most of them Freeware is a 
moonlighting project, in many cases 
developed on the bosses time. What 
about sales tax? What about income 
tax? One may need a million dollar 
budget to hit the top of the software 
charts, but what Freeware developer 
has the overhead of Ashton-Tate? 

We certainly should do everything 
possible to encourage the development 
of good, inexpensive software. Free- 
ware doesn’t encourage it. It lets some- 
one test market for free. Rather, let that 
person make contributions to the public 
domain without restriction, as for ex- 
ample, Rich Conn. When Rich offers a 
product commercially his name and 
reputation made in the field of public 
domain software is enough to sell the 
product. 

Speaking of taxes, one can kick 
around the question as to whether or not 
a tax exempt organization such as SIG/ 
M could actively distribute Freeware 
and still retain its tax status. In any 
event, the anti-freeware policy of SIG/ 
M has not produced a shortage of good 
software donations to the dismay of the 
advocates of Freeware. 


We have added to the library (SIG/ 
M Volumes 218, 219, and 220) Ron 
Fowler’s MEX. MEX represents a sig- 
nificant improvement in the field of CP/ 
M 80 modem programs. MEX brings 
Ward Christensen’s MODEM 7 up one 
generation. The Fowler program is 
good, but not without controversy. In 
putting it into the library we did so 
knowing that Ron did not provide the 
source code, which code is normally 
routinely provided with public domain 
programs. Freeware too does not pro- 
vide the source code, but for a different 
reason. Fowler did it to protect the pro- 
gram’s code from the tinkerers who put 
out 43 updates in two weeks. Ron went 
commercial with the 16 bit version of 
the program — but he did it as a com- 
mercial operation and not with hat in 
hand. We might add that the price he is 
selling the 16 bit version is not much 
different from the ‘Give Me’ sign that 


Steve Leon is the SIG/M Disk Edi- 
tor. In other words, he is the person 
who assembles, compiles and edits all 
the of the SIG/M public domain soft- 
ware disks. Thus, he speaks with the 
greatest authority as to what is going 
on in the SIG/M public domain soft- 
ware area. 


comes up everytime one runs the Free- 
ware. 

Speaking of 16 bit, Bill Earnest has 
taken RESOURCE, one of the better 
disassemblers, and turned it into a 16 
bit program. RES86 on SIG/M Volume 
223 is a handy tool for CP/M 86 users. 
Also on 223 are some NEC APC utili- 
ties and a program to set the function 
keys on the Wyse 50. 

SIG/M Volume 221 contains pro- 
grams for dBASEII users, including a 
complete inventory program. Volume 
222 has some utilities updates. In- 
cluded is an improved DBL. DBL 
allows a dot matrix printers to print 
double columns of type for newsletters 
and the like. Quite a handy utility for 
your Epson or Okidata printer. 

SIG/M Volumes are available on 
8’’ SS SD Disks for $6.00 each ($9.00 
foreign) directly from SIG/M, Box 97, 
Iselin, NJ 08830. Printed catalogs are 
$3.00 each ($4.00 foreign). Disks in a 
variety of formats may be obtained 
through the world wide SIG/M dis- 
tribution network. The distribution list 
is included with the printed catalog. A 
disk version of the catalog (Volume 00) 
is available for $6.00. 

SIG/M is a non-profit group oper- 
ated by non-paid volunteers and is a 
sub-group of the Amateur Computer 
Group of New Jersey, Inc. 

The following are the contents of 
the most recent SIG/M volume re- 
leases: 


Vol 218 MEX - Improved Modem for CP/M 
by Ron Fowler (Volume | of 3) 


MEX112 -OBJ MEX main program 
MEX -HQP On-line users manual 
MEX10 -DQC Documentation 
MEXSUM = .DQC 

MEXCON _.SUB __ Submit file 

MLOAD -OBJ Overlay install tool 
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READ -MQ Quick overview 

SET -MQX Changes MEX settings 
TEL .PHN Sample phone dir. 
MXM-CD10 .AQM Concord Data System 
MXM-PC10 .AQM_  Popcon 

MXM-UD10 .AQM UDS modem 
MXM-US13 .AQM_ US Robotics modem 
MXO-ADI1 .AQM_ Advanced Digital 
MXO-AL10 .AQM Altos 

MXO-PM22 .AQM PMMI 

MXO-SM14 .AQM_ Smartmodem 


Vol 219 MEX - Improved Modem for CP/M 
by Ron Fowler (Volume 2 of 3) 
MXO-APCC .AQM Apple II overlay 
MXO-CT10 .AQM CT Companion 
MXO-DB10 .AQM_ Dynabyte 
MXO-DT10 .AQM_ Datec 
MXO-DV10 .AQM_ Davidge 
MXO-EPI12. .AQM Epson QX 10 
MXO-GBI1 .AQM CompuPro 
MXO-H812 .AQM_ Heath H-89 
MXO-II12. .AQM_Intersystems 
MXO-IM10 .AQM_ Info-Mate 
MXO-KP41 .AQM_ Kaypro 
MXO-LOIS .AQM _ Lobo Max 80 
MXO-MD11 .AQM Morrow MD 3A 
MXO-MGI10 .AQM Mega SC 
MXO-MRI10 .AQM Morrow Micro Dec. 
MXO-NE88 .AQM NEC PC-8801 
MXO-NSI1 .AQM_ North Star Horizon 


Vol 220 MEX - Improved Modem for CP/M 
by Ron Fowler (Volume 3 of 3) 
MXO-OAI11 .AQM_ Otrona Attache 
MXO-OC10 .AQM_ Osborne | 
w/COMM-PAC 
MXO-OS22 .AQM_ Obsorne 
MXO-OX11 .AQM_ Osborne Executive 
MXO-PI-1 .AQM PCM Micromate 
MXO-R+10 .AQM_ RS Mod 4 with CP/M+ 
MXO-R211 .AQM_ Radio Shack Mod 2 
MXO-RS13_ .AQM_ RS Mod 4 
w/Montezuma 
MXO-RV13 .AQM_ Racal- Vadic 
MXO-SB12 .AQM_ Superbrain 
MXO-SCAT .AQM_ Smartcat 
MXO-SX10. AQM _ Starplex 
MXO-SY21 .AQM Sanyo MBC-100 
MXO-TD30 .AQM_ Turbodos 
MXO-TVI1 .AQM_ Televideo TS-802 
MXO-VPIO .AQM_ Ventel Plus 
MXO-VTLI .AQM_ Ventel w/Otrona Att. 
MXO-XE12 .AQM Xerox 820 
MXO-XRIO .AQM_ XOR S-100-4 


Vol 221 dBASEII(tm) Inventory System, 
Decoder, Patch and MP/M Info. 
DBASEMPM .LBR_ MPYM setup programs 
DBSOURCE .LBR _ Decodes run-time 
INVNTORY .LBR Inventory system 
NEWBASES .LBR_ dBASE patches 


Vol 222 Updates to Handy Utilities & Misc. 
Programs 

AREACD13 .LBR New areacodes 

DASM8080 .LBR 8080 disassembler 


DBLO003 -LBR = Multi column print 
DIRREP -LBR Repairs directory 
LU310 .-LBR Updated library util 


NULUI1O -LBR A new approach to LU 


Vol 223 RESOURCE Disassembler for CP/M 
86 Misc. Programs 
DBIIDATE .PRG NEC APC dBASE date 


DO -LBR Extended SUBMIT 
FREEBASE .LBR Data base program 
MEM -LBR_ = Creates RAM disk 


PDABACUS .CMD. Sets colors - NEC APC 
PDRAMDSK .AQ6_ RAM disk for NEC 


APC 
PDRAMDSK .CMD / 
RES86 .LBR  Disassembler-CP-M 86 


SPLITTER .LBR_ Segments files 
TLABEL86 .LBR_ Prints labels-CP-M 86 
WYSEFK21 .AQM Wyse 50 function keys. 


FULL SCREEN SYMBOLIC DEBUGGER 


“THE SINGLE BEST DEBUGGER 
FOR CP/M-80O. A TRULY 
AMAZING PRODUCT.” 


LEOR ZOLMAN 
AUTHOR OF BDS C 


Complete upward compatibility with DDT 

Simultaneous instruction, register, stack & memory displays 
Software In-Circuit-Emulator provides write protected memory 
execute only code and stack protection 

Full Z80 support with Intel or Zilog Mnemonics 

Thirty day money back guarantee 

On-line help & 50 page user manual 


ONLY S12 De 
—SOFTADVANCES— 


P.O. BOX 49473 AUSTIN, TEXAS 78765 (512) 478-4763 


YOUR S-100 SYSTEM TO 68000 POWER 
WITH OUR MULTIUSER HARDWARE/SOFTWARE 
PACKAGE THAT SUPPORTS 8 OR MORE USERS 


For as little as 
$1295* 


Time Sharing 

ulti-tasking 

ulti-Directory Filing System 
Password Protected Login 

RAM Disk 

ey] Device Independence 

‘includes our 68000 ia Printer Spooling 

Processor and Mirage Basic, Fortran, Pascal, APL, and 
Multi-User operating system FORTH compilers available 


CALL OR WRITE FOR DETAILS AND 
FOR OUR FREE S-100 CATALOG 


Inner Access Corporation 
4d Box 888 - Belmont, CA 94002 - 415/591-8295 


S/O 201m 


The trend in public domain MS/ 
DOS software distribution is in- 
creasingly through the user-support 
concept. Most authors are requesting a 
nominal donation. I have found there is 
no correlation between the requested 
donation and the quality of the software 
offered. Further, most of these pro- 
grams are only available in object code 
form. 

The authors are using the public 
domain as a way to enter the commer- 
cial software market without the inher- 
ent expense of media advertising. This 
is not the ideal way to build a public 
domain software library but it seems to 
be the common method of contribution 
used by most authors in the IBM PC 
environment. 

A very popular commercial soft- 
ware product today is Sidekick. This 
has spawned many other similar pro- 
grams which sit quietly in resident 
memory ready to be invoked at the 
user’s request. These programs are 
multifunction in nature. They are not 
full-featured electronic spreadsheets 
nor word processors nor communica- 
tion systems. These programs on the 
other hand offer calculator emulation, 
notepad reference, and system utility 
oriented support. A very neat one in 
public domain is PC-Window. This 
program features: a) alarm clock and 
split timer, b) scratchpad ASCII file 
read and write, and c) hex-decimal con- 
version. 

This program does not have the 
completeness of Sidekick but it certain- 
ly has the basics for programmer sup- 
port. PC-Window is most useful in re- 
minding the overly intent to keep track 
of his or her time on the machine. One 
can be so immersed in using the system 
that one loses track of time. There is 
more to life than just poking around on 
the machine. 

These resident programs are fairly 
complete in functionality. But, a word 
of caution is necessary. These pro- 
grams work by trapping interrupts. If 
you put enough of these utilities into 
resident memory, you will slow down 
your overall processing. Another cau- 
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PC/Blue Report 


by Hank Kee 


tion is that they may not work together. 
Some of the programs for normal 
everyday use become resident at load 
time. 

Home requirements are very differ- 
ent from the office workplace. As the 
PC matures, the focus of attention in 
software development turns to personal 
use support systems. We have in the 
recent releases of the PC/Blue library 
received some very fine examples of 
such programs, such as: Daily Diary — 
a time and manager program, 
PC/Calculator — calculator emula- 
tion, and Checkbook Distribution — a 
check balancing program. 

There are six new releases in the 
PC/Blue library bringing the total num- 
ber of volumes to 116. Here are the 
contents of the new releases. 


Volume 111 
Miscellaneous Utilities 
ASCII import into LOTUS 
blank monitor screen after wait 
encryption program 
Epson to Gemini code conversion 
file function queries 
Hebrew graphics extension 
HELP utilities 
one key control of multiple keys 
color graphics command attributes 
stack last ten keyboard commands 
logical reset of memory switches 
Epson MX80 options 


Volume 112 
Miscellaneous Utilities 
amortization program 
area code finder 
BASICA menu generator 
calendar generator 
dBASE menu generator 
redefine function keys 
resident keyboard/clock status 


popup nae 
MS/PC-DOS file utilities 
sorted directory displays 
global time/date stamp 


Volume 113 
Time and Money v1.1B 
A Simple Financial Monitoring 
System 


Editor’s Note: Hank Kee is the libra- 
rian for the PC/Blue public domain 
software library. He is the person who 
collects, assembles, and checks all the 
software issued by PC/Blue and then 
compiles and edits them into the re- 
leased volumes. 


Volume 114 
PC-Talk III (assembler version) 
QModem (compatible with 103A) 
Daily Diary v1.0 


Volume 115 
ScreenWrite Formatting Program 
PC/Calculator v1.0 


Volume 116 
Genealogy (dBASE) 
Church Management System 
(dBASE) 
Checkbook Management (dBASE) 
Checkbook Distribution 


The PC/Blue public domain soft- 
ware library is distributed on double- 
sided double-density disks formatted to 
be PC-DOS 1.10 and higher compati- 
ble. Clubs wishing to distribute copies 
of the library to their club members 
should contact Bob Todd to make 
arrangements to receive new releases 
automatically as they are issued. Bob is 
also the regional distributor of the SIG/ 
M library. 

Bob Todd, SIG/M-PC/BLUE 
Distribution 

Amateur Computer Group of NJ 

Box 97 

Iselin, NJ 08810 


The New York Amateur Computer 
Club handles submittals and individual 
distribution of PC/Blue disks and cata- 
logs. The disks are $7 domestic and $9 
foreign. A catalog describing the con- 
tents of each volume as well as topical 
cross-reference is $5. Foreign orders 
must be drawn on a US bank. 

New York Amateur Computer Club 
Box 106 

Church Street Station 

New York NY 10008 
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The C Forum 


This month, I will discuss building 
a translation program using the C lan- 
guage that is in the style of a UNIX 
filter. I mean it to be educational rather 
than practical, so I have forsaken com- 
pleteness and instead concentrated on 
ideas and program readability. My in- 
tent is that you should be able take what 
I’ve given you here and build on it. 


My example will be a program to 
‘*decipher’’ WordStar document files. 
It’s been a while since I’ve used WS, 
but for a long time it was my primary 
tool for word processing. More and 
more, I find myself using other editors 
and text processors. Some of the 
reasons are: 

1) WS doesn’t support high quality de- 
vices such as laser printers. 

2) WS doesn’t support bitmapped 
screens. 

3) WS isn’t as sophisticated as newer 
editors and text processors. 

4) WS isn’t integrated with other pro- 
grams that use text files. 

WS’s lack of integration is one of 
its more annoying traits. If you’re like 
me, you’ve probably typed in a good 
many documents through WS. Now, 
say we want to use a WS-text file as 
input to another program or even 
another computer system to be inte- 
grated into a non-WS document. 
We’ ve got problems. 

If you’ve ever printed a raw WS 
document file on your screen (without 
going through WS), you will have 
already noticed that there is more in the 
file than just the text. If you haven’t, try 
it. You will notice that most of the text 
appears, but some of the characters are 
wrong and there are a lot of non- 
printable characters embedded in the 
file. 

All the information is there, but WS 
uses the high-order bit in the byte for 
information as well as including extra 
bytes for print control characters. Un- 
fortunately, MicroPro will not give out 
the format of their WS document files, 
but don’t let that dissuade you. It’s not 
that difficult to decipher. 

Due to space limitations, I simply 
can’t cover all the goodies in WS. I’ve 
restricted myself to the things you are 
most likely to see, however, and fol- 
lowing my lead, it should not be hard to 
extend what I’ve given you. 
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Writing a 
translation 
program in C 


If you want to probe your own files, 
try loading them into the debugger and 
dumping the file so that you can see the 
byte codes alongside the ASCII charac- 
ters. After some studying it should be- 
come clear. This is what I found: 

1. Some characters have their most sig- 
nificant bit (MSB) on. This is used 
to denote several things (see below). 

2. Lines are terminated with cr-lf 
sequences. 

3. Dot commands (e.g. “‘.op’’) appear 
in the file verbatim. 

4. Blanks, with the MSB on, are soft, 
meaning they have been added auto- 
matically by WS to pad out the line. 

5. Hyphens, with the MSB on, are soft, 
having been added by a rejustify op- 
eration (although potentially with 
user guidance). 

6. Linefeeds, with the MSB on, are 
soft, having been added automati- 
cally. Hard linefeeds denote the end 
of a paragraph. 

7. WS print control characters (e.g. 
‘B) appear in the file verbatim. 

8. Tabs do not appear in the file, but are 
stored as blanks. 

9. All other characters appear as them- 
selves in the file. Characters at the 
ends of words in paragraphs that 
have been justified have their MSB 
on. 

Assuming that we want to transfer 
this file to another computer system, 
we must change the file so that it looks 
like an ordinary text file. This means 
that we have to do things like get rid of 
the high-order bits and remove the WS- 
dependent directives like the dot com- 
mands and the print control characters. 

Accompanying this column is a 
program I’ve written that handles the 
basic problems of ‘“‘unsofting’’ a WS 
document file. Most of the more 
esoteric features aren’t handled. 
However, given the start, you should 
be able to easily add the code to handle 
any additional conditions you find 
really necessary. 


by Don Libes 


You can also customize it to your 
application. With some simple changes 
it could be used to generate troff files, 
for example. The conventions I have 
chosen to use actually mimic 
“‘wsconv’’, a public domain program 
from the PC/BLUE software library 
(distributed without source, unfor- 
tunately), author unknown. 

I'll briefly go through some of the 
more interesting parts of the program. I 
will refer to source lines by the numbers 
running down the left hand side of the 
program listing. 

The program is written in the style 
of a typical UNIX filter. It copies its 
input to its output with appropriate 
modifications. Internally, the program 
sits in a loop, reading one character at a 
time. Based on the character attributes 
and the current state, the character is 
printed out and/or the state is changed. 

Lines 13-17 define and use 
#CONTROL. This macro generates 
control character values given the cor- 
responding letter. 

Lines 19-26 define the conventions 
for handling WS print control charac- 
ters. For example, an underlined string 
will print out as ‘‘<_string >’’. We 
actually use this convention when send- 
ing files to our typesetter. 

Line 28: Anything declared as 
“‘boolean’’ should only have the value 
TRUE or FALSE. This is purely a 
semantic interpretation since 
“‘boolean’’ is typedef’ed to “‘int’’. 

Lines 33-46 define several state 
variables that will be used to make deci- 
sions along with the next character. 

Lines 53-56: Our first problem is 
turning off the 8th bit on all characters. 
This is done by #toascii, defined in 
<types.h>. To remember that the bit 
was on, we use msb_was set. 

Lines 57-61: WS terminates lines 
with a crif. Assuming our system ter- 
minates lines with a nl (like a UNIX 
system), we can just disregard the cr. If 
a hyphen added by a justify operation is 
encountered, we attempt to remove it 
by delaying line wrap until we see the 
real end of the current word. 

Lines 62-64: For lack of space, I 
have chosen to ignore handling dot 
commands. They can be handled here 
without any problems. 

Lines 65-75: Spaces come in two 
flavors - soft and hard. Hard ones are 
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#include <stdio.h> 
#include <ctype.h> 
#aefine TRUE 1 
#aefine FALSE 0 


#cGefine N 
#faefine C 


#aefine SOFT _HYPHEN Oxlf /* inserted to break words at eol */ 
#uefine TAESIZE & 
#aefine CONTROL(x) ((x)-'a') 
#aefine BOLD (CONTROL ('b') ) 
#aefine SUPEKSCRIPT (CONTROL('t')) 
#define SUBSCRIPT (CONTROL ('v') ) 
#define UNDERSCORE (CONTROL('s')) 
#define BOLD_BEGIN Wee 
f#aefine BOLD_END Lie De Zhe 
#define UNDEKSCORE_ BEGIN ie 
#aefine UNDERSCORE_ END 2 oe 
#aefine SUBSCRIPT_BEGIN mare 
#faefine SUBSCRIPT _END ee 
#aefine SUPERSCRIPT_BEGIN Magen 
faefine SUPERSCRIPT_END Lee 
typedef int boolean; 
int column; /* column to output next character */ 
int c; /* last character read */ 
boolean superscript = FALSE;/* if superscripting */ 
boolean subscript = FALSE; /* if subscripting */ 
boolean bola = FALSE; * if emboldening x/ 
boolean underscore = FALSE; /* if underscoring */ 
boolean msb_was_set; /* if char most significant bit set */ 
boolean soft space = FALSE; /* if between words and have seen */ 
= * soft space, but no other spaces */ 
boolean soft hyphen = FALSE;/* if in the middle of a word that */ 
~ /* was hyphenated by ws */ 
boclean dotcmd = FALSE; /* if in the middle of a dot cmd */ 
boolean wrap soon = FALSE; /* if should wrap as soon es we get */ 
> /* to the end of the current word */ 
int spacerun = 0; /* number of spaces seen in a row */ 
main() { 
while (TRUE) { 


L *"\ni' 
R Woe 


/* look at single characters */ 

msb was set = FALSE; 

if (EOF == (c = getchar())) break; 

if (!isascii(c)) { /* is most sig. bit set? */ 
c = toascii(c); /* turn of most sig. bit */ 
msb_was_ set = TRUE; 


= CR) continue; /* always followed by an NL */ 
= NL) { 
if (soft hyphen) { 
wrap soon = TRUE; 
} else newline(); 
} else if (dotcmd) { 
/* throw away chars if we are in a dot command */ 
continue; 


} else if (c == ' ') { 
/* ignore blanks with msb set - they are soft */ 
if (!msb_was_set) { /* a real space */ 


soft space = FALSE; 
spacerunt+; 
columnt++; 
if (wrap soon) { /* wrap now! */ 
newline (); 
wrap soon = FALSE; 
} a 
} else soft space = TRUE; 
} else if (c == SOFT HYPHEN) { 
/* ignore hyphens with msb set - they are soft */ 
soft hyphen = TRUE; 
} else if (c == '.' && column == 0) { 
/* text processing directive */ 
dotcma = TRUE; 
} else if (iswsentrl(c)) { 
/* ignore wordstar print control characters */ 
/* e.g. “S (underscore), “B (bold) */ 
wscntrl(c); 
} else if (iscntrl(c)) { 
/* unknown cont.vl character - ignore */ 
continue; 
} else { /* normal character */ 
/* if we encountered a soft space, stick in at */ 


C Forum Continued from Page 16 
real, but soft ones have been added by a 
justification operation. Tabs are de- 
noted by hard spaces, so we’ll try to 
undo that too. 

Line 79 recognizes the start of a dot 
command. 

Lines 82-85 handle WS print con- 
trol characters. wscntrl() does every- 
thing. iswscntrl() just recognizes the 
characters. 

Lines 86-88 remove all the other ws 
control characters we are too lazy to 
correctly handle. 

Lines 89-104: If the character 
hasn’t been handled at this point, its got 
to be text, which is just passed through. 
If we’re at the beginning of a word, we 
also perform the translation of spaces 
back to tabs here by calling space _out(). 

Lines 108-130 define space out(). 
This routine takes a source and destina- 
tion column, and prints out the least 
number of tabs and spaces to move the 
cursor to the destination column. 

Lines 152-180 define wscntrl(). 
This translates control character direc- 
tives into printable versions. 


I encourage readers to write to me 
about topics or problems that you want 
to know about. I want this column to 
reader driven. Write to me care of 
Micro/Systems Journal, Box 1192, 
Mountainside NJ 07092. 


C Source Code 
for the PC 


Concurrent C $45” 
LEX $25” 
YACC $25” 


Tools $15” 


Austin Code Works 
11100 Leafwood Lane 
Austin, TX 78750 
512-258-0785 


ENGINEERING SOFTWARE 


CPM-80 *° MSDOS * TRSDOS + PCDOS* 


Free Catalog and Signal Processing Booklet 


Professional — Affordable 
PLOTPRO — Scientific Graph Printing Program $49.95 


ACNAP2 — AC Circuit Analysis Program $69.95 
DCNAP — DC Network Analysis Program $59.95 
SPP — Transient Signal Processing $59.95 


PCPLOT — Pixel Resolution Graphics Program $59.95 
*96 Computers and formats, 8087 Co-processor versions of 
ACNAP2, DCNAP, SPP available for $10.00 more 


/£ Ug Engineering 
Professional Software 


2200 Business Way, Suite 207 © Riverside, CA 92501 
(714) 781-0252 


/* least one space */ 

if (soft space) { 
spacerun = 1; 
columnt++; 
soft_space = FALSE; 

} 

if (spacerun) { /* beginning of word */ 
/* calculate tabs and blanks to lay down */ 

space out(column-spacerun,column) ; 
~ spacerun = 0; 
} 


putcher(c); 
columnt++; 


} 


/* print least number of spaces & tabs to move from "oldpos" */ 
/* to “newpos" */ 
space out(olapos,curpos) 


int oldpos; /* old position */ 

int newpos; /* new position */ 

{ 
int spaces, tabs; /* number of spaces & tabs to print */ 
int i; 
if (oldpos >= newpos) return; /* no space in between */ 


/* first calculate tabs */ 
tabs = newpos/TABSIZE - oldpos/TABSIZE; 


/* now calulate spaces */ 

/* if old & new at same teb stop, its just difference */ 
if (tabs == U0) spaces = newpos - oldpos; 

/* if not, then its remainder from nearest tab stop */ 
else spaces = newpos % TABSIZE; 


for (i=U;i<tabs;i++) putchar('\t'); 
for (i=0;i<spaces;i++) putchar(' '); 


} 


/* true if wordstar control character */ 


boolean 
iswscentrl(c) 
int ¢; 
{ 
if ((c == BOLD) || 

(c == UNDERSCORE) |] 

(c == SUPERSCRIPT) |] 

(c == SUBSCRIPT)) return(TRUE); 


else return(FALSE) ; 
} 


newline() 
{ 
if (!dotemd) putchar('\n'); 
column = 0; 
spacerun = 0; 
aotcma = FALSE; 
} 


wscntrl(c) 
cher c; 
{ 
switch (c) { /* print control character */ 
case BOLD: 
if (bold) printf (BOLD END) ; 
else printf(BOLD BEGIN) ; 
bold = !bold; = 
break; 
case UNDERSCORE: 
if (underscore) printf (UNDERSCORE END); 
else printf (UNDERSCORE BEGIN) ; al 
underscore = !underscore; 
break; 
case SUBSCRIPT: 
if (subscript) printf(SUBSCRIPT END); 
else printf£(SUBSCRIPT BEGIN); ~ 
subscript = !subscript; 
break; 
case SUPERSCRIPT: 
if (superscript) printf (SUPERSCRIPT END); 
else printf (SUPERSCRIPT BEGIN); ~ 


superscript = !superscript; 
break; 

default: 
/* unknown - ignore for now */ 
break; 
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Turbo Pascal Corner 


Borland International revolution- 
ized the microcomputer world in 
October 1983 by releasing the Turbo 
Pascal compiler for $49.95. Since that 
time, the Pascal language has under- 
gone a rebirth of interest — mostly due 
to the ease of writing and compiling 
programs with Turbo Pascal and the 
powerful extensions to the language it 
provides. Borland has sold over 
250,000 copies of Turbo Pascal in 
about 18 months. In March, Borland 
announced Turbo Pascal version 3.0 
with several extensions for $69.95. 

This column will feature tips and 
techniques for using Turbo Pascal pro- 
ductively on MS-DOS and CP/M mic- 
rocomputer systems. We will discuss 
typical problems and their solutions. 
Reader suggestions, comments, and 
questions are encouraged. You may 
address comments to: 

Turbo Pascal Corner 

P.O. Box 699 

Pine Grove, California 95665 


WordStar Conversion Utility 

WordStar is one of the three pro- 
grams to become a million seller, most- 
ly due to its availability in the early 
days of microcomputing. Though 
many use WordStar, few understand 
how it actually works with text files on 
a character level. Our featured program 
this issue is a utility written in Turbo 
Pascal to convert WordStar files to 
standard ASCII files. 

WordStar uses the ‘‘eighth bit’’ or 
parity bit of some characters in its text 
files to mark them for later format pro- 
cessing. The ‘‘standard’’ ASCII char- 
acter set does not use the eighth bit. 
WordStar files may also include ‘‘dot 
commands’’ (lines beginning with a 
period) for format instructions and 
“*print enhancement mode commands’’ 
(control characters like “S for under- 
line) mixed in with the text. 

Normally, this is not a problem, but 
if you wish to transfer text files to other 
systems (word processors, typesetters, 
spreadsheets, databases) or send files 
via electronic mail (i.e. MCI Mail), 
you must first translate WordStar for- 
mat files to ‘‘standard ASCII’ files. 
Some of this translation can be done by 
using the WordStar Global Find and 
Replace function, but this is a time con- 
suming and error prone process. The 
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‘“‘hidden’’ or ‘‘soft’’ characters using 
the eighth bit are not easily modified by 
WordStar. In addition, some print con- 
trol characters (like “S) cannot be 
searched for in WordStar. 

A solution is to write a text transla- 
tion program in Turbo Pascal. One 
possible program is presented at the end 
of this discussion. It is not overly elabo- 
rate due to space constraints, but more 
options, menus, color displays, and so 
on are easily added. Text translation 
falls under the general category of fil- 
ters, and this generalized program de- 
sign may have many more applications 
than just WordStar format translation. 


The Program 

The main program is quite short, as 
is typical in Pascal. It displays a title 
and calls the menu, open files, process, 
and exit procedures. The Turbo Pascal 
window built-in procedure allows easy 
set-up of partial display screens and is 
used throughout the program. 

The program does not contain any 
unusual data structures, but several 
arrays are used. The print mode control 
characters are in constant array spe and 
their ‘‘plain text’’ string substitutes are 
held in two more constant arrays — 
pcon for beginning the print mode and 
peoff ending the print mode. The vari- 
able array flagpe contains boolean 
values indicating whether a given print 
mode is currently active. 

The variable array numlist is used 
to hold the byte values of the characters 
in each input line. Using an array con- 
taining the byte value of each character 
cuts down on the number of type con- 
versions needed in the translation por- 
tion of the program. 

The menu procedure uses a simple 
display format and a yes/no input func- 
tion — inyn to return a boolean value 
for each translation option. This func- 
tion could be included in the menu pro- 
cedure, but is left as a global function 
for future growth. 

Open files is a fairly standard open 
file procedure with error checking. It 
checks for a pre-existing output file and 
requires user confirmation before over- 
writing the file. 

Procedure process keeps track of 
lines and characters processed and calls 
procedures getline, test_line, and 
translate_line. 


The get_line procedure inputs each 
character’s byte value into the line 
array. Each line is terminated by detect- 
ing a high bit masked line feed charac- 
ter. A simpler version of the program 
could process one character at a time. 
However, in this example, an entire 
line is processed at one time to allow 
advanced parsing functions to be built 
onto this basic program structure. 
Some types of translations require con- 
textual look-ahead and look-back capa- 
bility. 

Input lines beginning with a ‘‘dot’’ 
or period can be completely ignored if 
the ‘‘Strip dot commands?’’ menu op- 
tion is selected. This operation is 
handled by the test line procedure, 
which sets variable translt to false if 
the line should be skipped. 

The actual translation is done by the 
procedure translate line. Tests are 
performed on the byte array values and 
the values are translated as required. 
Finally non-null characters are written 
to the output file. The only unusual 
operation is the substitution of print 
mode commands, where starting and 
ending modes must be detected using 
flagpe and the appropriate string substi- 
tuted for the WordStar control charac- 
ter (i.e. ‘S becomes either [us] or 
[eus ] ). 

The easiest part of the translation is 
to strip the ‘‘high’’ or eighth bit off 
each character. This can be done by 
logical and-ing each character’s value 
with 127 (hex 7f) as shown by this 
simplified fragment: 
read(infile ch); {read character } 
chnum := ord(ch); {get its value } 
lonum := chnum and 127; {strip high bit by anding} 
write(outfile,chr(lonum); — { write character } 

Most other translation operations are 
performed by simple tests and substitu- 
tions. 

The program can be speeded up by 
eliminating the screen display of lines 
and characters processed, or showing 
only the final counts. You are encour- 
aged to modify it for your own require- 
ments. 

This program, its ‘‘big brother’’, 
and other Turbo Pascal public domain 
programs are available 24 hours a day 
for free downloading on the ‘‘High 
Sierra RBBS’’ system at 209/296- 
3534. 


David W. Carroll is a freelance wri- 
ter and computer consultant living in 
the Sierra Nevada foothills near 
Sacramento, California. He is the au- 
thor of Telecommunications with the 
IBM PCjr published by Prentice Hall 
in March 1985 and Programming with 
Turbo Pascal to be published by 
McGraw Hill this summer. 
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program wsutil; 


{WordStar file 
{Copyright 
{ 


{Converts WordStar files to ASCII text files 


1985 


utility -- 
by 


3-27-85 
David WwW. 


Ver B5 
Carroll 


{with options. 
const 
nummax = 200; {Maximum input line lengthj 
version = *BS’; 
date i *March eT, 1985’; 
null = OO; 
bell = OT; 
lf = 10; 
tf S £2; 
cr = 13; 
nobrksp rs 15; {mo break space “0O} 
softhyphi = 30; {mid-text soft hyphen} 
softhyph2 = 31; feol soft hyphen} 
space = 32; 
hyph = 45; 
period = 46; 
softlf = 138; {soft line feed) 
softcr = 1414; {soft carriage return} 
softsp = 160; {soft space} 
ctlb = 02; 
ctld = O4; 
ctls = 19; 
ctlt = 20; 
ctlv = 22; 


arrays pcon and pcoff contain the strings that are} 
substituted for WordStar print control characters } 


“b, “d, “s, “t, 
mumber of WS 


and ‘“v. Constant pe is the 


print control 


characters supported. 


pe = O5; 


spc:array[i..pc]) of byte=(ctlb, ctld, ctls, ctlt, ctlv); 


Pcon: array[i..pc) of string[i0} = 
(’Cb#)’,’Cas)’,’{us)’,’(sup)’,’*fsub)’); 
peoff: array[i..pc] of string[10} = 
(Leb#f]’,’Leds)’,’feus)’,’fesup])’,’fesub)’); 
var 
infile text; 
outfile text; 


numlist 


array(i..nummax) 


of byte; 


flagpe array[i1..pc] of boolean; 
totchrin real; 
totchrout reali 
ent integer; 
quit boolean; 
stripsp boolean; 
striplf boolean; 
chegpc : boolean; 
stripdc : boolean; 
strippe : boolean; 
transit boolean; 
procedure open_files; 
var 
infname string[(20]); 
outfname : string[20]; 
ans 3 strineg[10}; 
goodfile boolean; 
begin 
window (1,5,80,25); 
repeat 
CirScr; 
write (‘Input filename --> ’); 
readin (infname); 
assign(infile,infname); 
{sI-} reset(infile) {$14}; 
goodfile := (1IOresult = 0); 
if not goodfile then 
begin 
write (chr(bell)); 
writeln (’FILE ’,infname,’ NOT FOUND’); 
delay(3000) 
end; 
until goodfile; 
window (1,6,80,25); 
repeat 
ClirScr; 
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total } 


write (‘Output filename --> ’); 
readin (outfname); 
assign (outfile,outfname); 
{$I-} reset(outfile) {$I+)}; 
goodfile := (IOresult <> 0); 
if not goodfile then 
begin 
write (chr(bell)); 
write (‘FILE ’,outfname,’ EXISTS, OVERWRITE? (y/n)’); 
readin (ans); 
goodfile @= (UpCase(ans[1i])=’Y’) 
end; 
until goodfile; 
rewrite(outfile) 
end; 
procedure get_line; 
var 
ch char; 
num byte; 
lonum byte; 
begin 
ch:=chr(0); 
lonum::0; 
num::0; 
cnt:-=0; 
while not eof(infile) and (lonum<>lf) do 
begin 
ent:sscnt+i; 
read(infile,ch); 
totchrin := totchrin + 14; 
num:-ord(ch); 
lonum:=-(num and 127); 
numlist[(cnt):-num; 
end 
end; 
procedure test_line; 
begin 
translit := true; 
if stripdc then 
if numlist{1}=period then transit := false; 
end; 
procedure translate_line; 
var 
spstr string[10}; 
indxi : integer; 
indx2 3 integer; 
indx3 integer; 
num byte; 
chnum : byte; 
lonum byte; 
exch boolean; 
begin 
for indxt:=-i1 to cnt do 
begin 
exch := false; 
num:=-numlist[indx1]; 
chnum := num and 127; 
lonum :=chnum; 
if (num-softhyphe2) then 
chnum := hyph 
else if (num-softhyphi) then 
chnum : null; 
if num=-nobrKsp then chnum := space; 
1f chgpe then 
begin 
for indxe:=1 to pe do 
begin 
if ifoneauB spcpAdnaKajhénen 
bePfain 
chnum := null; 
exch := true; 
if flagpc{indx2]) then 
spstr := pcofffindx2) 
else 
spstr := pconfindx2]; 
flagpc[indx2) := not flagpc{indx2] 
end 
end 
end; 
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(num-softsp) then chnum 
Qonum:-lf) then chnum : 


if stripsp and 
if striplf and 


if strippce then 
for indx3 := 1 to pe do 


if lonum = spc{indx3] then chnum =: 


<= null; 


null; 


null; 


bDegin 
window(1,7,80,25); 
CirScr; 
line:=0; 
totchrin::0; 
totchrout:=-0; 


for indx :=i1 to pc do 


if chnum < null then flagpcfindx] := false; 
begin 
write (outfile, chr(chnum)); while not eof(infile) do 
totchrout := totchroutti begin 
end; line:-line+i; 
if exch then get_line; 
begin test_line; 
write(outfile,spstr); if translit then 
totchrout := totchrout + length(spstr) begin 
end translate_line; 
end window(1,12,80,16); 
end; CirScr; 
writein(’Line + *,line:5); 
function inyn boolean; writeln(’Total characters input:’,totchrin:6:0); 
var writeln(’Total characters output:’,totchrout:6:0); 
ans strineg[i10); writeln(’Total filtered(+)/added(-): 
begin and (totchrin-totchrout): 
write([y/n)  "); end 
readin(ans); end; 
inyn := (Upcase(ans(1}) = ‘Y’) procedure exit; 
end; begin 
window(1,23,80,25); 
procedure menu; CirsScr; 
begin writeln(’Translation completed!’); 
writeln; writeln(outfile); 
writeln(’*Wordstar to ASCII Conversion’); close(infile); 
he petite close(outfile) 
write(’ 1. Strip soft-spaces (un-justify)? ’); end; 
stripsp <= inyn; 
write(’ 2. Strip line feeds? *); begin 
Strapit == inyn, aes ahs ClirScr; 
write(’ 3. Change control (print) commands? ’); writeln; 
an oe he esa hip Ae Pommatey writein(‘WordStar File Conversion Program’); 
stripdc :=: inyn; writeln(’Copyright 1985 by David W. Carroll’); 
if chgpe = false then writeln(’Version #’,version,’ of ’,date,’.’); 
begin writein; 
write(’ 5. Strip print commands? ”); window(1,5,80,25); 
strippe ‘<= inyn; CirScr; 
menu: 
strippe := false; Cirser; . 
writeln; if not quit then 
write(’ Quit? ae a begin 
quit := inyn; open_files; 
end; process; 
exit 
procedure process; ena 
var 
line integer; else 
indx integer; writeln(’Translation cancelled.’); 


end. 


MODEL 100 C COMPILER 


Now you can write efficient programs for your 
TRS-80 model 100 with ease. Or, learn the 
essentials of C programming while traveling! 


C/100 - THE “PORTABLE” C COMPILER 
Cassette version 

Disk/Video interface version 

Model II version (run on mod Il, then 
download object code to model 100) . . $79.00 
Model III version (as above for Mod III) . $79.00 


Write or call for information on other 
TRS-80 software. 


business utility software 


109 minna ste 423 san francisco ca 34105 


(415) 397-2000 


MODELS Il, 12, 16 
MODELS Ill, 4 


TRS/C C COMPILER 

Full K&R with source to the 
function library. UNIX 
compatible 


ZSPF EDITOR 

SPF, the choice of most 
mainframe programmers, is 
now available for Z80 machines. 
And it’s panel driven so you 


FORTRAN 
PROGRAMMERS 


Discover why 
you should be using 
F77L 
the complete implementation 
of the ANSI FORTRAN 77 
Standard for the IBM PC and 
compatibles. 

If you are serious about your 
FORTRAN programming, you 
should be using F77L. 
$477 
[ss Lahey Computer 
— Systems, Inc. 


31244 Palos Verdes Drive West, Suite 243 
Rancho Palos Verdes, California 90274 
(213) 541-1200 
Serving the FORTRAN community 
since 1969 


TAKE THE PAIN OUT OF BACKUP 


Famous Excuses For The Remedy: Copy 
Not Doing Backups Just What’s New — 
Automatically! 


Backing up a Winchester onto multiple 


floppies takes forever. Qbax2 will: 
PIP makes you remember what you Split files bigger than one floppy. 
changed — too much trouble. Track all the pieces. 


Tell you which floppy it needs and when. 
Give you a built-in catalogue. 
Reclaim wasted floppy space. 


Disk failures only happen to the other guy. 


Floppy-To-Floppy 
Incremental Backup Qbax2 only $95 from: 
For Only $40. Amanuensis, Inc. 
Like PIP but copies just % R.D.1, Box 236 
the files that have changed. y°N Grindstone, PA 15442 
Order Qbax1. (412) 785-2806 


For CP/M 22 on 8” SSSD and popular 514” formats. Shipping $2 U.S. and Canada, $4 overseas. Qbax TM 
Amanuensis, Inc. CP/M® Digital Research. 


FOR EVERYONE WITHOUT A DISPENSATION FROM MURPHY’S LAW 


THE PROGRAMMERS SHOP 


helps compare, evaluate, find products. Straight answers for serious programmers. 


SERVICES i RECENT DISCOVERIES 
fa oe Free Literature - Compare Products : : 
+ Compare Products + Newsletter Evaluate products Compare competitors. Learn about new alternatives. One free call SMALL TALK for PCDOS - “Methods 
+ Help find a Publisher + Rush Order brings information on just about any programming need. Ask for any “Packet” or has objects, windows, browser, 


“Addon Packet ADA, Modula 0) “Al” COBASIC C COBOL CO Editors 
] FORTH 


+ Evaluation Literature tree  - Over 700 products inspector. PCDOS $239 


+ BULLETIN BOARD - 7 PM to 7 AM 617-826-4086 


“C” LANGUAGE [REET EDITORS Programming LANGUAGE LIBRARIES FORTRAN consiow pole: 


FORTRAN 


PASCAL () UNIX/PC or 


Debuggers, Linkers, etc 


MSDOS: C86-8087, reliable Call OUR GRAPHICS: GraphiC-source inC MSDOS 219 MS FORTRAN-86 - Impr MSDOS $ 239 
Instant meh . fast, - 495 RUNS ON PRICE lag! ay FTN, PAS Bae a DR Fortran-86 - full '77" 8086 249 
Lattice C - the standar call : Pl -fast, full-all lang 1 PolyFORTRAN-XREF, Xtract PCDOS 165 
Mrosoft ¢ 3.0 new a inl eal gare AIR FLEMGNT BTrew-al'ng — MSQ0S_ 215 i 

illiams, debugger, fast Call ilon - PCDOS 1 ndex + -source, no royal 

CPMBO.EcoPlus C-faster, SLR 275 te EMS gD 2re—_CTree-source, no royal tae OTHER PRODUCTS 
BDS C- solid value 125 PMATE-powertul 8086 185 dBC ISAM by Lattice 8086 229 Assembler & Tools - DRI 8086 159 
MACINTOSH: Hippo I! 375 VEDIT-tull, liked 86/80 119 dB VISTA- “Network” Structure MSDOS 465 Atron Debugger for Lattice PCDOS 395 
Megamax - optimizer, full 275 XTC- multitasking PCDOS 95 PHACT-up under UNIX, addons MSDOS 225 English - dBase to C MsDOS 750 
Consulair's MAC C 275 OTHER: CUtil by Essential MSDOS 129 C Helper: DIFF, xref, more 86/80 135 
Compare, evaluate, consider other Cs COBOL } e Greenleaf - 200 + MSDOS 159 CODESMITH-86 - debug PCDOS 139 

CSharp - Real-Time MSDOS 600  — MacASM-ull, fast, tools MAC 115 
Dig. Res-decent MSDOS 500 PORTABLE C to PC, Mac, Il Many 125 MBP Cobol-86 - fast 8086 885 
RUNS ON Macintosh COBOL-Full MAC 1850 SOFT Horizons - Blocks | PCDOS = 139 Modula 2 for MAC, PCDOS 90 

Active Trace-debug 86/80 75 MBP-Lev. II, native, screen MSDOS 885 SCREEN: CURSES by Lattice PCDOS 125 —— Micro: SubMATH-FORTRAN full © 86/80 250 

BASCOM-86- MicroSoft 8086 279 Micro Focus Prof.-Full PCDOS call CView - input, validate PCDOS 195 Microsoft MASM-86 MSDOS 125 

BASIC Dev't System PCDOS 115 Microsoft-Lev ll, no royal MSDOS 500 MetaWINDOW - icons, clip PCDOS 139 MSD Debugger PCDOS 119 

BetterBASIC - 640K PCDOS 185 Ryan McFarland-portable © MSDOS 695 PANEL - many lang, term MSDOS 249 Mutilink - Muttitasking PCDOS 265 

CB-86 - DRI CPM86 419 ProScreen - windows, source PCDOS 415 PC/FORTH + -well liked MSDOS 219 

Prof. BASIC Compiler PCDOS 89 Windows for C MSDOS 175 PFIX-86 Debugger MSDOS 169 

CADSAM-Full Btree, source MSDOS 150 Ss Mi Sices one 

SCREENSCULPTOR  PCDOS 115 : : olylibrarian - thoroug 

for log, literature, and solid value PolyMAKE PCDOS 95 

Ask about ISAM, other addons for BASIC Call fora catalog, literature, a d PROFILER by OWB - flexible MSDOS 109 

Prolog-86-Learn, Experiment MSDOS 125 
| SERVICE| - = SYMD debugger-symbols PCDOS 119 
TRACE86 debugger ASM MSDOS 115 


ALL PRODUCTS - We carry 700 products 
for MSDOS, CP'M 86, CPM 80, Mac- 
Intosh and key products for other 
micros 


THE PROGRAMMER’S SHOP™ 


128-mRockland Street, Hanover, MA 02339 
Mass: 800-442-8070 or 617-826-7531 | MasterCard 


Note: All prices subject to change without notice 
Mention this ad. Some prices are specials 
Ask about COD and POs. All formats available 


Visa 8517 


Build an 


PC Bus 
Converter 


S-100 


Having been an S-100 computer 
user for the past 8 years I have always 
taken joy in the fact that I had a better 
computer system than many “‘ready 
made’’ computers that appeared and la- 
ter disappeared over the years. As more 
memory, floppy disk drives, and hard 
disks began to appear as essential com- 
ponents for a good system I simply 
shopped around for the appropiate S- 
100 boards. During that time I had writ- 
ten my own personalized monitor to do 
all those things one wants a computer to 
do exactly as I wanted them done. Over 
the years in fact I have built up a com- 
plicated web of hardware units that 
involve: a second S-100 slave computer 
to handle multi-printer I/O, speech 
synthesis, keyboard single key to mul- 
tikey translations, numerous video 
boards as well as a master/slave 
arrangement for Z80 and 8086/8087/ 
8089 CPU control transfer. This rather 
complicated system is driven by 
CPM80+, CPM86, and MSDOS disk 
operating systems. There is still no 


sap - 7 
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Build an interface 
so you can use PC 
video, disk 
controller and 1/0 
hoards with your 
S-100 system. 


doubt in my mind that the S-100 bus is 


the best suited for my needs. Because it 
is a 16-bit bus it is faster than the IBM- 
PC. 

As time went by a serious limitation 
of the S-100 bus became apparent. 
Computer board manufacturers were 
no longer supporting the bus as much as 
they did in the past. Perhaps the best 
example of this was the long delay in 


by John Monahan 


bringing out an S-100 video board that 
was both software and hardware com- 
patable with the PC. The cruel hard fact 
of life is that the PC market is larger 
than the S-100 market, so many board 
manufacturers rushed into that arena. 
This has led to a good supply of many 
types of PC bus boards (memory, I/O, 
disk controllers, video, clock boards to 
name only a few). A second result of 
this interest in the PC bus is that the 
almost oversupply of manufacturers 
has lead to a supply of good boards at 
very low prices. 


Why build a converter? 

As I watched this drift away from 
the S-100 bus, I wondered how many 
companies would be smart enough to 
avoid the oversupplied PC market. I 
waited for them to expand their S-100 
bus board set. In particular I was look- 
ing for an PC compatible video board. I 
waited and waited and waited.... No- 
thing happened. In desperation I consi- 
dered putting together my own S-100 
video board. A careful examination of 
IBM’s technical manuals revealed that 
this would not be all that simple. All 
those clock circuits scared me off. Be- 
sides I would have to really build two 
boards. One for monochrome and one 
for graphics. 

Then I had an idea. If I could not get 
an PC compatible video board for the 
S-100 bus, why not make a board that 
would convert S-100 bus signals into a 
form that could be utilized by PC’s 
boards. In other words make an S-100 
to PC-bus converter board. 

The crude outline for the project 
Started to take shape in my mind. I 
would build one S-100 board that 
would connect the S-100 bus over a 
buffered ribbon cable to a second 62- 
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pin bus (on its own motherboard) that is 
compatible with the IBM-PC bus. In 
this way my S-100 system would talk to 
PC cards as if they are on the S-100 bus 
itself. In fact, from a software point of 
view the 8086 would not know on 
which hardware bus the board resides. 

As new PC boards arrive, I simply 
plug them into my extended bus. I now 
have the best of both worlds. My old 
S-100 system with most of its memory 
in fast static RAM (16 bit), its hard disk 
and memory disk etc. all well oiled and 
at the same time it has the capability to 
take on PC boards. While I have many 
boards in my system that I have con- 
structed and would like to talk about, it 
is the S-100/PC converter board I 
would like to describe here. 


Building the converter 

To begin with, this is not a con- 
struction project for a novice. There 
are bus drivers on both bus interfaces 
of this board. Incorrect activation of 
these chips could severly damage your 
system. Only take on this project if you 
are sure you understand what you are 
doing. Perhaps this article may interest 
a hardware manufacturer to contact me 
to mass produce the board in which 
case you will not have to put in the 
hours of work required to carry off such 
a project. 

Finally, dynamic memory on some 
PC memory boards is not refreshed by a 
controller on the memory board itself 
but rather by the cycling of a 8237 
DMA controller on the system board. 
This continuous reading of RAM once 
every 72 clock cycles (7% of bus band- 
width) keeps the dynamic RAM re- 
freshed. At present I do not have a 
DMA controller on my PC mother- 
board to refresh RAM since I have no 
need for one. Should you wish to inter- 
face (slow) PC compatible memory 
boards with your S-100 system you will 
have to address this problem. The main 
use of this converter board is to inter- 
face PC video boards, disk controllers, 
I/O boards and the like. 


The PC bus signals 

To understand how this board 
works we will have to examine all the 
PC signals and describe how this board 
simulates them via their S-100 coun- 
terparts. The S-100 signals are well de- 
scribed in Sol Libes & Mark Garetz’s 
book ‘‘Interfacing to S-100/IEEE 696 
Microcomputers’’. The PC signals are 
well described in the IBM-PC Technic- 
al Reference Manual (In my 1981 edi- 
tion, pages 2-9 to 2-12). The PC bus 
consists of 62 pin connectors arranged 
as 2 rows of 31 pins each. One side is 
numbered Al to A31. The other is B1 
to B31. These are: 
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FIGURE 1 


Al -I/O CH CK Provides the CPU 
with parity error information if an error 
is detected on any IBM card. It is nor- 
mally high and is only pulled low when 
an error is detected. This signal is simp- 
ly passed directly on to S-100 bus via 
NMI int line (pin 12) using an open 
collector output (figure 4). 

A2 - A9 Data bits 0 to 7 These lines 
pass 8 bit data to and from PC cards. 
Because PC uses an 8088, all data is 8 
bits wide. 16 bit transfers are sent or 
received as two 8 bit data units by the 
processor. Our first complication is that 
I use an 8086 on my S-100 bus. For 
reasons I do not want to go into here, I 
do not have the capability on the 8086 
board of talking to 8 bit memories. It 
will be clearly necessary on our conver- 
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ter board to convert 16 bit data to 8 bit 
units to interface to the PC data lines. I 
also have an old (backup) S-100 8088 
board, the converter will also work 
with this board in 8 bit mode (ie. the 
S-100 sKTRQ* is not used). 

A10 +1I/O CH RDY This line (nor- 
mally high or ‘‘ready’’) is pulled low 
by a memory or I/O device to lengthen 
CPU access time to the device. In par- 
ticular it is used by PC dynamic mem- 
ory boards to refresh their memory 
cells. It turns out that this is perhaps the 
most critical line to be interfaced to the 
S-100 bus. I will discuss it in more 
detail later. Suffice to say that the S- 
100 bus must never access or leave the 
PC bus when this line is low (i.e. not 
ready). 
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All +AEN Indicate when a DMA 
controller has control of bus. Because I 
do not implement DMA that originates 
on the PC bus, line is not used and is 
tied low. 

A12-A31 AO - A19 The address 
lines on bus to address memory and I/O 
devices. They are directly comparable 
with the S-100 address lines and are 
connected directly to both buses via 
drivers. 

B1 This is one of the bus ground 
lines and is connected directly to the 
S-100 ground lines (pins 
20,50,53,100). 

B2 RESET DRV Used to reset or 
initialize system logic on the bus. It is 
active high. The S-100 RESET line 
(pin 75) is active low, so we must invert 
the S-100 signal on the converter board 
before connecting it to the PC bus. 

B3 +5V Unlike the S-100 bus the 
PC bus provides filtered 5 volts directly 
to its cards. Because a number of cards 
may be on the bus, the supply current 
may be considerable. I supply 5 volts to 
the PC bus from a 5 Amp +5 voltage 
regulator placed on the PC mother- 
board. This is enough for a few cards 
but may need to be increased later. 

B4 IRQ2 This is one of 6 Interrupt 
request lines used to signal the CPU 

‘that an I/O device needs some sort of 

attention. An interrupt is generated by 
raising IRQ2 line and holding it high. 
The S-100 bus has interrupt request 
lines also. However they are active 
low. These signals are jumperable on 
converter card and inverted. 
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B5 -5VDC A -5 volts supply pro- 
vided to PC cards that require this vol- 
tage. A simple | amp voltage regulator 
on PC motherboard is sufficient. 

B6 +DRQ2 The DRQ lines on PC 
bus are used by devices such asa DMA 
controller to request control of bus 
away from 8088. The S-100 bus also 
has DMA request lines. However a 
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DMA request originating on PC side of 
converter bus could become a can of 
worms. For the moment I choose to 
ignore these lines. 

B7 -12VDC A -12 volt supply pro- 
vided to PC cards that require this vol- 
tage. A simple | amp voltage regulator 
on the PC motherboard is sufficient. 

B8 We get off light for this one 
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FIGURE 3 


since no function has yet been assigned 
to this pin by IBM. 

B9 +12VDC A +12 volt supply 
provided to PC cards that require this 
voltage. A simple | amp voltage reg- 
ulator on the PC motherboard is suffi- 
cient. 

B10 GND Same as B1. 

Bll -MEMW Instructs memory 
devices to store data that is on data bus 
(active low). Corresponding S-100 sig- 
nal is MEMW (pin 68). Since it is ac- 
tive high it must be inverted. 

B12 -MEMR Instructs memory de- 
vices to read data that is on data bus 
(active low). The corresponding S-100 
signal is sSMEMR (pin 47). Since it is 
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active high it must be inverted. 

B13 -IOW Instructs I/O devices to 
store data that is on data bus (active 
low). Corresponding S-100 signal is 
sOUT (pin 45). Since it is active high it 
must be inverted. 

B14 -IOR Instructs I/O devices to 
read data that is on data bus (active 
low). Corresponding S-100 signal is 
sINP (pin 46). Since it is active high it 
must be inverted. 

B15 -DACK3 One of the 3 bus 
DMA acknowlege lines. Goes low 
when 8088 grants a DMA request. The 
S-100 bus has DMA acknowledge lines 
also. However I have not utilized them. 

B16 +DRQ3 Same as BO. 


B17 -DACK1 Same as B15. 

B18 -DRQI1 Same as BO. 

B19 -DACKO Same as B15. Used 
by PC to refresh system dynamic mem- 
ory. 

B20 CLK This is the IBM-PC bus 
system clock (4.77 MHz , 33% duty 
cycle). Since the system clock on my 
S-100 system will normally be running 
at a very different frequency (8 MHz at 
present), it is clearly necessary to 
generate a separate system clock on the 
PC motherboard. The simplest way to 
do this is copy the PC directly by using 
an 8284A clock generator (figure 4), 
insuring that timing on the bus will be 
exactly as in a PC. 

B21-B25 IRQ7-IRQ3 More inter- 
rupt lines; see B4. 

B26 -DACK2 Same as B15. 

B27 +T/C Provides a pulse when 
terminal count for any DMA controller 
is reached; not used in my system. 

A28 +AEN The address latch en- 
able signal produced by the PC 8288 
Bus Controller chip. The falling edge 
of this signal indicates that a valid 
address is on the bus. The S-100 
pSYNC (pin76) signal is quite compati- 
ble with this signal. 

A29 +5VDC Same as line B3. 

A30 +OSC A high speed clock 
with a 70 nsec. period (14.31818 MHz) 
and a 50% duty cycle. Since this signal 
is used for many video boards it must be 
accurate. It is generated exactly as IBM 
does using an 8284A clock generator 
directly on the PC motherboard. 

A31 +GND Another ground same 
as BI. 


The above describes all PC bus sig- 
nals. Now let us see how we connect 
them to the S-100 bus. 

Figure | shows the connections for 
the S-100 address lines. Because all 
signals are being sent over a ribbon: 
cable (in my case 2 feet long), it is 
necessary to buffer signals at both ends 
of the cable. I use 74LS244 line drivers 
with pins | and 19 tied to ground to 
enable the devices. Also, just to be on 
the safe side I run a ground line between 
each address line in the cable. The 
address lines with stars above them (eg. 
A19*) are simply S-100 signals buf- 
fered through the 74LS244. These are 
used elsewhere on the board. This in- 
sures that each S-100 bus signal has 
only a single gate load. It is very con- 
fusing at first glance to see the PC 
address pins A12 to A30 refer to the pin 
numbering system not to the value of 
the address line itself.S-100 pin 75, 
RESET is inverted through a 74LS04 
before becoming RESET DRV on the 
IBM bus. pSYNC becomes ALE. IO 
RDY on the IBM bus is inverted and 
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FIGURE 4 


then passed on to an open collector in- 
verter 7406 to become XRDY. Address 
line AO from the S-100 bus is processed 
in a special way (see below) to become 
AO*. This is sent to address line 0 on 
the PC bus (pin A31). 

Figure 2 is the heart of the circuit. 
Let us consider first 8 bit memory read 
or write. If the IBM select circuit (de- 
scribed below) determines that the S- 
100 CPU is addressing a board in one of 
its PC windows, the QI output of one- 
shot Al will go high after pS YNC goes 
high. At the same time the not Q output 
of Al will go low holding the S-100 bus 
in a permanent wait state. The read/ 
write strobe going to the PC board (fi- 
gure 4) will cause IBM WAIT to go 
high. When this is over (and it is impor- 
tant to remember that this is highly vari- 
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able, depending on for example, status 
of 6845 on IBM video board), the input 
to A2 will go low. At this point there is 
valid data on the IBM bus. A2 output Q 
latches the data for an 8282 (described 
below) and A2 not-Q output clears 
single shot Al, which removes the wait 
state from the S-100 bus. 

Things are a bit more complicated 
for 16 bit memory read or write. We 
must read/write the lower (AO=0) 8 bits 
of data, raise AO, and then read/write 
the odd 8 bits of data. It is necessary to 
completely remake the ALE and R/W 
strobes for the IBM bus the second 
time. The low order R/W cycle for the 
(AO=0) is exactly the same as de- 
scribed above except now when A2 
clears the wait state setup by Al, the 
S-100 bus is still held in a permanent 


wait state by the not Q output of B1. 
This is because now the S-100 signal 
SIXTN went low triggering B1. After 
the low order address data is latched 
into the 8282 (see above) there is a short 
delay via B2 after which the falling 
edge of B2 triggers the start of the 
second cycle. Pins | and 15 of the 
74LS368 (figure 4), which enable the 
read/write strobes, temporarily go 
high. They then return low. The PC 
sees this as a new R/W strobe. See 
figure 6 for a detailed timing diagram. 
We also raise AO via single shot E and 
relatch the address lines by a pulse from 
single shot D. When the R/W strobe 
comes down, the IBM Boards think a 
new board access is required. After the 
(variable length) wait state is generated 
(via IBM WAIT) the single shot F is 
triggered. This in turn clears B1, which 
in turn removes the wait state held on 
the S-100 bus. 

Both I/O read and write are 
assumed to be carried out as 8 bit trans- 
fers by the S-100 CPU. sINP generated 
inputs will arrive from the IBM bus (if 
the correct port is mapped, see below) 
to the ‘*data in’’ S-100 bus lines via the 
74LS245 shown in figure 3. A careful 
analysis of the diagram will show that 
pin 19 of this chip (the output enable 
pin), will always go low when sINP 
goes high and IBM SEL is high. sOUT 
generated outputs will travel to the IBM 
bus via the 74LS244(A) shown in fi- 
gure 3. Pins | and 19 of this chip go low 
when sOUT and IBM SEL are high. 

If you are using a CPU that has an 
8088 (i.e. no 16 bit requests) you can 
simplify figure 3 by changing jumper 
b1-2 to position b2-3 and cl-3 to cl-2. 
This effectively removes the 8282 latch 
forcing all ‘‘data out’’ to go through the 
74LS244(A) and all *‘data in’’ to arrive 
via the 74LS245. 

Figure 4 shows how the read and 
write strobes are connected to the IBM 
bus. Because some static memory 
boards may not put a wait state on the 
IBM bus (ie. lower IO RDY) when they 
are read or written to, and the circuit in 
figure 2 requires at least a minute pulse 


of a wait state. a minimal IBM WAIT 
state signal is generated via single shot 


The 74LS245 in figure 4 is a 
bidirectional transceiver for the 8 data 
lines going to the IBM bus. It is enabled 
when IOR,IOW,MEMR or MEMW 
goes low. Pin | determines the direc- 
tion. You may jumper the IBM bus IRQ 
lines as you wish. 

The 8284 clock generator circuit is 
exactly as utilized by IBM. It is neces- 
sary to place this circuit on the IBM 
motherboard to have sharp signals. 

The only remaining section is the 
mapping system (figure 5). Because 
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one will normally only want a certain 
portion of the S-100 16M bytes of 
memory to map into the IBM bus hard- 
ware we must enable the board only 
when this occurs. The 74LS684 can be 
jumpered to go low only when the cor- 
rect memory range is addressed. The 
jumpering is done so that a high or low 
address line on one side of the chip 
matches a high or low on the other. This 
should be familiar to anybody putting 
memory boards together. If the correct 
memory range is being addressed, IBM 
SEL will go high and be used as de- 
scribed above. 

Mapping of I/O ports is essentially 
the same. Up to 4 blocks of I/O ports 
(figure 5) can be used. Clearly this 
could be expanded. For example the PC 
uses ports 3B0O to 3BF for its 
monochrome display. The jumpers 
shown are addressed for this range. 
Note that unconnected inputs on a 
74LS682 are internally pulled high. 

Table I shows the capacitor and re- 
sistor values for the one-shots used in 
figures 2 and 4. While putting the board 
together I used variable resistors to fine 
tune the system. There is much room 
for upward variation in the values. Fi- 
gure 6 shows the scope traces at various 
points on the board when the small test 
program shown in figure 7 is run. This 
test can be used when adjusting the R-C 
values of the one shots. In the program 
a continuous series of 16 bit, 8 bit even 
and 8 bit odd reads to the PC video 
board are made. The scope is triggered 
on pin 12 of the 74LS11 in figure 2. The 
scan rate is | micro-sec/cm. 


Table 1 


Resistor-Capacitor Values 
For 74LS123’s 


IC Resistor Capacitor 
Al 9Kohms S10pF 
A2 14Kohms SOpF 
Bl 24Kohms 510pF 
B2 18.8Kohms 47pF 
Cc 10.7Kohms S6pF 
D 6.1Kohms S6pF 
E 16.3Kohms 330pF 
F 5.8Kohms 30pF 
H 1Kohm 180pF 


This is not a simple project. 
However the advantage of having the 
ability to use PC boards in your S-100 
system makes this project worthwhile. 
There are many ways this board could 
be improved. I intend, at a later date, to 
upgrade it to be compatible with the 
IBM-AT bus system, and to an on- 
board DMA controller on the mother- 
board. I will be pleased to collect any 
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circuit improvements you may have. 

Finally, it must be pointed out that 
to utilize the full advantage of this sys- 
tem you must interface it with the cor- 
rect software. For example, I use 
IBM’s ROM BIOS drivers for their 
monochrome and color video boards 
almost word for word out of their tech- 
nical manual. These form part of a 
CONIO device driver for my custom 
MSDOS system. 

In future articles I hope to tell you 
about my S-100/PC keyboard adaptor 
unit and an S-100 8086 slave CPU 
(which utilizes an 8087 and 8089) that 
has the best elements of many commer- 
cial CPU boards. These boards when 
combined with good software (written 
by a friend of mine that for example 
utilizes the 8089) yields an S-100 sys- 
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tem that today knocks the socks off 
anything in the non S-100 arena. 


;Program to generate test pattern 
;for IBM-PC converter board. Code 
;written for Digital Research's 

7 ASM86. 


CSEG 
org 0 
mov ax,O0bC00h 
mov ds,ax 
mMOv bx,0 
more: mov Word Ptr. [BX],ax 
mov Byte Ptr [BX],al 
inc bx 
mov Byte Ptr [BX],al 
dec bx 
jmps more 
DSEG 
org 160h 
Gb 0 
END FIGURE 7 
29 
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FIGURE 8 — BUS PIN FUNCTIONS 


John Monahan is a molecular 
biologist. He received a Phd in Bio- 
Chemistry from MacMaster University 
in Ontario Canada. John has been a 
computer hobbyist for the past ten 
vears and has built several homebrew 
systems. He has been a member of the 
Amateur Computer Group of New 
Jersey for over 9 years and recently 
moved to the San Francisco bay area. 
He can be contacted at: Box 1908, 
Orinda CA 94563. 


Running MS-DOS On S-100 Systems 

It should be pointed out that the 
IBM-PC version of MS-DOS, as well 
as the versions for most of the PC 
clones, can be purchased separately of 
the systems at most computer stores. 
However, these versions contain sys- 
tem I/O drivers that are not compatible 
with most S-100 systems. Neither 
Microsoft nor any of the equipment 
manufacturers provide the system in- 
itializing files necessary to port MS- 
DOS to another hardware configura- 
tion. Seattle Computer Products, did, 
until a short time ago sell a version of 
MS-DOS that contained the SYSINT 
files necessary for the job. 

If you own a CompuPro system 
then you can buy a version of MS-DOS 
2.0 already configured for your system 
from Computer House, 20 Oak Grove 
Ave, Woodacre CA 94973, tel: 
(415)897-6387. 


If you own a Lomas Data System, 
then you can buy a preconfigured ver- 
sion of MS-DOS from them (see their 
ad in this issue). 

People using the Tarbell Electro- 
nics 816 S-100 board can boot a stand- 
ard IBM-PC version of MS-DOS. 
Although they would be better off 
buying a non-IBM version of MS-DOS 
which contains disk versions of Basic 
and BasicA. 


Concurrent-DOS from Digital Re- 
search is also MS-DOS compatible. 
The current version (3) is compatible 
with MS-DOS Version 1. DRI is ex- 
pected to shortly release Concurrent- 
DOS 4.1 which is expected to be MS- 
DOS Version 2 compatible (and also is 
expected to include the GEM 
Macintosh-like user interface). Con- 
current-DOS V3 is available for several 
S-100 systems. For example, 
CompuPro furnishes an implementa- 
tion for use with their S-100 80286 
CPU and new PC-compatible video 
display cards (a review of which is in 
the works). And they are promising to 
furnish Concurrent-DOS V4 as soon as 
it is available. 

DRI, like Microsoft, furnishes 
Concurrent-DOS strickly as an OEM 
product. It does sell, via retailers, an 
IBM-PC (and compatibles) version. 
However, the software necessary to 
configure it for a particular hardware 
configuration is provided only to 
OEMs. DRI no longer markets any 
configurable operating systems to non- 
OEM customers and no longer provides 
support for its old configurable CP/M 
operating systems. 

We are attempting to find a way in 
which other S-100 8086 users can im- 
plement MS-DOS or Concurrent-DOS 
on their systems. If any reader can help 
in this regard please call me. 

Sol Libes, editor 
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MOTEL COMPUTERS LIMITED 

174 BETTY ANN DRIVE, WILLOWDALE, 

TORONTO, ONTARIO, CANADA M2N 1X6 
(416) 221-2340 


Interfacing To 


MS-DOS 


by William G. Wong 


Editor’ s Note: MS-DOS is today far 
and away the most popular single-user 
16-bit disk operating system. Not only 
does it run on the IBM-PC but an in- 
creasing number of other systems (in- 
cluding 8086, 80186 and &80286-based 
S-100 systems) also use it. Also, there 
are other operating systems (e.g. Con- 
current DOS from Digital Research 
Inc.,) that are compatible with MS- 
DOS. Therefore, I feel that our readers 
would like to know more about writing 
applications software to interface to 
MS-DOS and other MS-DOS compati- 
ble operating systems. It was with this 
in mind that we commissioned Bill 
Wong to write this series on software 
interfacing to MS-DOS. 


MS-DOS, from Microsoft, Inc., 
has become one of the most popular 
operating systems for 8086-based mic- 
rocomputers. This is primarily due to 
the popularity of the IBM PC imple- 
mentation called PC-DOS. This series 
describes application interface to MS- 
DOS V2.x and PC-DOS V2.x which 
will be referred to as DOS. DOS pro- 
vides a standard interface to the disk 
file system and peripherals so that the 
same programs can be run on different 
8086 machines running DOS, without 
change. 

This series of articles will address 
the assembly language interface and 
how the functions are used by applica- 
tion programs. This first part covers the 
program segment prefix, access to 
DOS, and how to terminate a program. 

Subsequent parts will cover charac- 
ter output, DOS CP/M-like file access 
and DOS UNIX-like file access. All 
numeric values listed in this article are 
hexadecimal unless noted otherwise. 


Program Initialization and the Prog- 
ram Segment Prefix 

DOS programs come in two fla- 
vors, .COM files and .EXE files. The 
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Part | — the 
program segment 
prefix, access to 
DOS, and how to 
terminate a 
program 


primary difference between the two is 
that .COM files contain no relocation 
information and the program size is 
therefore limited to 64 kbytes. .EXE 
files contain relocation information 
which allow programs larger than 64 
kbytes to be loaded. 

In either case, the programs are 
loaded just above a memory structure 
called the Program Segment Prefix 
(PSP). The PSP is 256 bytes long and 
contains the following information. 


Byte 
Offset Description 

0 INT 20 instruction (Terminate 
program) 

2 First paragraph of unallocated 
memory 

4 Reserved 

5 Intrasegment (Short CALL) 
DOS entry point 

(Function code passed in 
register CL) 
(Valid only for functions 

0-24) 

6 Number of bytes in this 
segment 

A Termination interrupt vector 
(IP, CS) 

E Control break interrupt vector 
(IP, CS) 

12 Critical error interrupt vector 
(IP, CS) 


16 Reserved 
2C_ Program Environment 
segment number 
2E_ Reserved 
50 Intersegment (Long CALI) 
entry point to DOS 
(Function code passed in 
register AH) 
(Valid for all function 
numbers) 
5C Formatted parameter area | 
Formatted parameter area 2 
80 Default disk transfer area (128 
bytes) 


The PSP looks very much like the 
base page of a CP/M-80 system. A call 
or jump to offset 0 will terminate the 
program and the operating sytem can be 
accessed at offset 5 although only the 
CP/M-style DOS functions (0-24) are 
accessible through this interface. Also, 
the default disk transfer area and for- 
matted file name parameters are at their 
CP/M locations. This similarity aids in 
translation of programs from CP/M to 
DOS. 


The Program Environment segment 
contains ASCII strings of the form 
‘“*‘NAME=parameter’’. This is one 
method of passing parameters to ap- 
plications and is set via program control 
or a DOS command (SET, PATH, or 
PROMPT). 

The default disk transfer area con- 
tains the unformatted parameter string 
(normally the starting command line) 
less any redirection characters and file 
names. The first byte of this area con- 
tain the size of the parameter string 
followed by the string itself. This string 
is formatted into the two buffer areas at 
5C and 6C. The initial value in the AX 
register indicates the status of these 
buffers as follows: 


AL = 00 indicates first formatted 
drive specifier is valid 
FF indicates drive specified 
is invalid 
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Move over, Crosstalk®... 


| 


IN 


Last year, the NightOwl 
delivered MEX, the 
Modem EXecutive that 
tamed the 8-bit com- 
munications frontier. 


This year, he’s doubled 
his byte with MEX-PC — 
the supercharged 16-bit 
communications pack- 
age for the IBM-PC — 
and he’s looking to take 
on the big boys, feature 
for feature. 

plus $5 for shipping 


$59.95 and handling 


(includes MEX-PC software and com- 
plete manual) 


The NightOwl’s in town 
and he’s packing a 
16-bit MEX! 


Supports all popular modems @ Pro- 
grammable for unattended 
operation @ Extensive HELP 
overlay @ Auto-dial and redial 
@ Alternate long distance dialing 
(ALD) e “List’’ dialing with auto- 
matic baud switching @ Instant de- 
fining of IBM-PC function keys @ 
Fast creation of custom “smart” 
phone directories @ All popular 
protocols — extended Christensen 
XMODEM (Checksum and CRC) Com- 
puServe A, ASCII (X-on, X-off) odd- 
even-none bit parity e@ A CLONE 
routine for unlimited creation of cus- 
tomized versions @ Full access to 
your own operating system and soft- 
ware while logged onto a host 
system @ Delay-adjustable Break 
key @ DOS-compatible commands 
@ Supports all monitors, port 
switching, named directories, on-line 
printing @ IBM-PC-XT-AT — all DOS 
levels @ 110 to 19,200 baud on most 
equipment @ Source code for any 
overlay available 


“Individually, each of these fea- 
tures enhances the experience 
of telecomputing, but together 
they add up to enormous 
power and flexibility. . . one 
of the most innovative and so- 
phisticated communications 
packages available. . . MEX has 
been greeted with universal ac- 
claim.” 

That’s how Link-Up magazine 
described the 8080 version of 
MEX last September. Now, 
there’s MEX-PC! 


You’ve struggled with over- 
priced, so-called smart termi- 
nal software long enough. 


Now, experience the genius, 
the economy, the power! of 
MEX-PC. 


Give us a call at 1-800-NITEOWL = = 


(in Wisconsin, call 414-563-4013) 


Crosstalk XVI is a trademark of Microstuf, Inc., Atlanta, GA 


MEX.-PC is a trademark of NightOwl Software, Inc., Rt. 1, Box 7, Fort Atkinson, WI 53538 


NightOwl 


‘tware, inc. 


AH = 00 indicates second formatted 
drive specifier is valid 
FF indicates drive specified 
is invalid 


The other register settings depend 
upon the program type. COM programs 
have all segment registers set to the 
segment containing the Program Seg- 
ment Prefix. The instruction pointer 
register (IP) is set to 100 hex where the 
program code resides. The stack poin- 
ter register (SP) is set to the end of the 
segment and 100 hex bytes are allo- 
cated to the segment. A zero is placed 
on top of the stack thereby allowing a 
program to exit via a short return in- 
struction (RET) as many CP/M prog- 
rams do (this is also a CP/M translation 
assist). Any COM programs which in- 
voke another program must first free all 
unnecessary memory before invoking 
the program. 

The EXE programs have more in- 
formation than the COM files. The 
code segment (CS) and stack segment 
(SS) registers are set based upon this 
information as are the IP and SP regis- 
ters. The data (DS) and extra (ES) seg- 
ment registers are set to the Program 
Segment Prefix. 


DOS Interrupts 

DOS is accessed via 8086 interrupt 
instructions. An interrupt instruction 
(INT) has a single byte value (0-255) 
associated with it. This value is the 
interrupt number. An interrupt instruc- 
tion indexes the interrupt vectors lo- 
cated at the base of memory. The vec- 
tors contain the new code segment (CS) 
and instruction pointer (IP) registers for 
the interrupt support routine. The inter- 
rupt instruction also saves the current 
FLAGS, CS and IP registers on the 
stack. The interrupt routines typically 
return control to the program using the 
interrupt return (IRET) instruction. 
However, some interrupt routines exit 
via long return (RET) instructions leav- 
ing the FLAGS register on the stack. 
Also, routines which cause program 
termination never return to the calling 
program. 

Some interrupt vectors are prede- 
fined for 8086 error and hardware sup- 
port functions. Others are allocated to 
DOS with the remaining vectors avail- 
able for various functions, and some 
are reserved for future use. The DOS 
related functions are described in the 
rest of this section. 

INT 20 (Terminate program and re- 
lease all memory being used) 


The active program is terminated. 
All file buffers are flushed but all files 
should be closed before the interrupt is 
issued. Interrupt vectors for INT 22 , 23 
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and 24 (termination handler, control- 
break handler, and critical error hand- 
ler) are restored. 

INT 22 is issued to terminate the 
process. The INT 22 vector from parent 
program will be the one restored and 
used. This is normally COMMAN- 
D.COM if only one other program is 
active. 

The code segment (CS) register 
must hold the segment address of the 
Program Segment Prefix for proper ter- 
mination. 

INT 21 (DOS Function Request) 

DOS functions are called using this 
interrupt. The function number is 
placed in register CL with other para- 
meters being passed in other registers 
depending upon the function. These 
functions will be discussed in this and 
subsequent articles. In general, a DOS 
function request looks like: 


MOV CL,DOS FUNCTION ; cl := DOS function number 
INT 21H ; perform DOS function 


INT 22 (Issued when program is ter- 
minated) 

INT 22 is invoked by DOS when a 
program is terminated. These vectors 
are initially set by the command proces- 
sor, COMMAND.COM. Control re- 
turns to the command processor when 
an application terminates via this inter- 
rupt routine. Programs which start 
other programs can also regain control 
upon termination of the other program 
in the same fashion. 

A program must set the values of 
this interrupt vector before initiating 
another program. The vector values are 
restored to their prior value when the 
initiating program terminates so it is not 
possible for a program to to process its 
own termination request. 

INT 23 (Control-break intercept) 

The control-break exit routine is 
called by DOS I/O routines if a control- 
break is issued from the keyboard. The 
program will continue execution if this 
routine exits via an interrupt return 
(IRET). The other way to exit from this 
routine is via a long return. This leaves 
the flags on the stack. The program is 
continued as with an IRET if the carry 
flag is not set. Otherwise, the program 
is terminated. All registers must be pre- 
served if the program is to be con- 
tinued. 

INT 24 (Critical Error Handler) 

The critical error handler routine is 
called whenever a critical I/O error 
occurs from DOS which is called via 
INT 21. Critical errors encountered 
from INT 25 or INT 26 are not handled 
by this error handler. Note, DOS per- 
forms 5 retries before issuing an INT 
24. Exit from this routine is via an 
IRET. The new program state is in- 
cluded in the AL register as follows: 


O means that error should be 
ignored and program should con- 
tinue execution. 


—_ 


indicates that operation should be 
performed again and program ex- 
euction should continue. Note: 
retry may generate another error 
which would again cause an INT 
24. 


2 causes program termination via 
INT 23. 


Upon entry DP:SI contains the De- 
vice Header Control Block address. 
The bits in register AH indicate the 
device type and error if the device is a 
block device. The following table con- 
tains the bit designations. 


Bit Description 
QO Operation (0 = read, 1 = 
write) 
1-2 Disk area affected: 
1 = file allocation table area 
(FAT) 
2 = DOS directory 
3 = DOS data file area 


The least significant byte of DI con- 
tains the error code with more detailed 
information. The following table con- 
tains the error code values. 


Error 
Code Description 
0 Attempt to write to a 
write-protected disk 
Unknown unit 
Block device drive not ready 
Unknown or illegal 
command 
Block device data (CRC) 
error 
Incorrect request structure 
length 


WN 


nan 


Block device seek error 

Block device unknown 
media type 

Block device sector not 
found 

Character device (printer) 
out of paper 

Write fault 

Read fault 

General error not defined 
above 


sO 


oo 


aAwD> oOo 


The stack contains the following in- 
formation from DOS and the user prog- 
ram. Note, the first item is on top of the 
stack. 


Register Description 
IP DOS registers from INT 24 
CS 

FLAGS 
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AX User registers at time of 
INT 21 


IP User registers from INT 21 


Interrupts are disabled when this 
routine is entered. The contents of reg- 
isters SS, SP, DS, ES, BX, CX and DX 
must be preserved. Only DOS function 
calls 1 through 12 may be used as all 
others change the contents of the DOS 
stack which is currently being used by 
this interrupt support routine. Also, the 
DOS state may change such that the 
system will crash. 

Although the contents of the device 
header are available, it.should not be 
altered in any way. Control can be pas- 
sed directly to the user program by res- 
toring the user registers and executing 
an IRET instruction. 


INT 25 and INT 26 (Absolute disk 
read and write) 


These interrupts perform disk op- 
erations that bypass the normal DOS 
file system. Direct access to any sector 
on the disk is possible. All errors are 
returned directly to the calling prog- 
ram. Parameters are passed in the fol- 
lowing registers. 


Register Description 
AL Drive number (A = 0, B = 
1, etc.) 
CX Number of sectors to read or 
write 
DX First logical sector to 
transfer 


DS:BX Transfer address 


Sector size is the physical sector 
size of the device. The first physical 
sector on the first cylinder is logical 
sector 0. Although entry to these func- 
tions is via an INT instruction, the func- 
tions exit via a long return (RET) in- 
struction. This leaves the original 
FLAGS on top of the stack. These must 
be removed when the calling program 
regains control. The carry flag (not the 
one in FLAGS on the stack) will be zero 
if no errors occurred and it will be one if 
an error occurred. Error results are re- 
turned in AX. The error codes in AL 
match the ones returned in the DI regis- 
ter for INT 24. One of the following 
error codes will be returned in AH. 
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Error 
Code Description 
80 Attachment failed to respond 
40 Seek failed 
20 Hardware controller failed 
10 Bad data (CRC) error 
08 Data lost due to DMA 
overrun 
04 Cannot find requested sector 
03 Write attempted to 
write-protected disk 
02 Address mark not found 
00 Error not listed above 


INT 27 (Terminate program but re- 
main resident) 


A program can terminate itself but 
remain resident in memory using this 
interrupt. This operation is normally 
performed by hardware or software in- 
terrupt support programs after they 
have initialized the corresponding 
hardware and interrupt vectors. Prog- 
rams of this type remain resident and 
can be accessed by other programs 
which are run after the resident prog- 
rams terminate. Access is typically per- 
formed via INT instructions and inter- 
rupt vectors which may point to table 
addresses. 

A program may also terminate itself 
and remain resident using DOS func- 
tion number 31. The advantage of using 
function 3] is that a completion code 
can be returned while none can be re- 
turned via INT 27. Also, the resident 
size of the program is not restricted to 
64 kbytes. 

There are also some restrictions on 
the program being terminated. First, 
the program may not be an EXE prog- 
ram which will be loaded in high mem- 
ory. Second, the maximum size of the 
memory segment which remains resi- 
dent is 64 kbytes. One time initializa- 
tion code may extend past this point 
since it may be overwrittten by subse- 
quent programs. Third, vectors for INT 
22, 23, and 24 are restored when the 
program is terminated even if the prog- 
ram changed their values. 

Upon exit, the program must have 
set the code segment registers to the 
base segment to be retained and the size 
of the segment in bytes must be placed 
in the DX register. The resident prog- 
ram is then considered an extension to 
DOS. The following is an example of 
terminating a resident program. 


MOV DX,RESIDENT SIZE ; DX := resident size in bytes 
INT 27H ; exit and remain resident 


DOS Function Invocation 

Unlike CP/M, DOS functions can 
be invoked through an number of diffe- 
rent methods. The normal method is 
using INT 21 with the function number 
in the CL register. A short call to offset 


5 in the Program Segment Prefix will 
work too but only for function numbers 
between 0 and 24. A long call to offset 
50 will work for all functions but the 
function number is passed in register 
AH. 

All other register values are func- 
tion specific. 
DOS Program Terminate Functions 

The historical program termination 
has been through DOS function 0 or by 
a direct BIOS call. The later corres- 
ponds to INT 20 described earlier 
although INT 20 is not used as the 
BIOS entry point. DOS function does 
terminate a program which essentially 
performs an INT 20. All requirements 
and restrictions are the same. An exam- 
ple of this type of termination is: 


MOV CL,O ; CL := terminate program function 
INT 21H ; execute DOS function 


A program may terminate but re- 
main resident by using DOS function 
31. This is similar to INT 27 but allows 
the resident portion of a program to 
exceed 64 kbytes and also return an exit 
code to the system. The DX register 
must contain the number of paragraphs 
(16 bytes/paragraph) to retain while the 
AL register contains the exit code. 

This function DOES NOT release 
any other allocated memory which the 
program is using so all unnecessary 
memory should be released before 
issuing this function call. Here is an 
example of a resident program DOS 
terminate function call: 

MOV DX,RESIDENT PARAGRAPHS; dx := resident size/16 


MOV AL,EXIT CODE ; al := program exit code 
MOV CL,31H ; Cl := terminate resident program 
INT 21H ; perform DOS function 


There is also a DOS function which 
allows a program to terminate and still 
return an exit code. This is DOS func- 
tion 4CH. The exit code is returned in 
AL. All files are closed but it is good 
practice to close the files before invok- 
ing this function. This function is the 
only way to terminate a program with- 
out having to set the code segment reg- 
ister (CS) to the segment containing the 
Program Segment Prefix. An example 
of this function is: 

MOY AL,EXIT CODE 
MOV CL,4CH 
INT 21H 


; al := exit code from program 
; Cl := terminate program function 
; execute DOS function 


Summary 

Although program termination, in- 
terrupts and the Program Segment Pre- 
fix represent a small part of the DOS 
interface, it is a start and does allow 
creation of a minimal program. The 
next article will address console char- 
acter input and output which will en- 
able you to write a program that prints 
something. 
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For some time now I have been 
aware of PC clone boards being sold via 
mail order and at computer flea mar- 
kets. I was very dubious about them, 
having heard about all sorts of compati- 
bility problems with them (see Henry 
Kee’s article in last month’s Micro/ 
Systems Journal). However, I finally 
decided to take the plunge. 

It happened at a computer flea mar- 
ket I recently attended here in New 
Jersey. Several vendors were selling 
parts that ranged from bare mother- 
boards, to boards with a bag of parts, to 
a board with sockets, on up to a fully 
populated and tested board which came 
with a BIOS ROM and a 90-day war- 
ranty. The bare-board price, with some 
rather skimpy instructions (a board lay- 
out diagram, parts list, and if you were 
lucky, a schematic diagram) cost $60, 
while the populated/tested/guaranteed 
board typically cost $295. I decided to 
go for the latter. One vendor even 
offered me a board with a copy of the 
IBM-PC BIOS ROM. However, being 
in the public position that I am in, I 
ended up buying a board with the board 
manufacturer’s BIOS ROM. 


What Did It All Cost? 

The motherboard cost me $295. A 
100 Watt power supply was $95 (a 
135W supply was about $110). A 
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How | assembled 
a PC clone for 
under $1,000. 


keyboard was $75, a graphics control- 
ler card $130, and a floppy disk con- 
troller card, with cable, was $75. I also 
bought a used half-height double-sided 
floppy disk drive for $50 (new they 
were $85) and a monochrome display 
for $65. I then bought a copy of MS- 
DOS from a Compaq dealer (list was 
$60 and I got it for $50). A total cost of 
$835. 


A few weeks later I decided to get a 
case for the unit ($70), another floppy, 
and additional memory chips (192K for 
$30) to bring the total memory up to 
256K. With these last items the price 
came to $985. I have also ordered a 
10.5Mbyte drive and controller for the 
unit ($450) and the dealer swapped my 
100W power supply for a 135W unit for 
the difference ($15). This brought the 
entire system price up to $1,475 . Not 
bad for a complete 10.5Mbyte PC com- 
patible system. I figure I saved about 


It even looks like 
an IBM/XT. 


PC Clone 


By Sol Libes 


$1,200 over a PC compatible (e.g. 
Compaq) and about $1,700 over an 
IBM/XT. 


Putting Together A Taiwan Cony 

The motherboard, disk and display 
controller cards and the keyboard, 
power supply and cabinet were made 
by a company called ‘‘Super Compu- 
ter’’. I think they should change their 
name to ‘‘Not So Super Computer’’! 

The motherboard came with a few 
xeroxed sheets on how to turn on an 
assembled unit and how to open the 
case to install additional boards. . . that 
was it. There was no documentation on 
how to connect the power supply or 
how to set the switches on the mother- 
board. Connecting the power supply 
presented a problem since there are two 
identical connectors from the power 
supply to be plugged into the mother- 
board. What I ended up doing was 
looking at an IBM-PC to see how the 
connections were made and copying it. 

I connected the power supply to the 
motherboard and to my drive. Plugged 
in the display and disk controller cards 
and the keyboard to the connector on 
the back of motherboard. Then I 
hooked up my display monitor to the 
display controller card and put the 
Compaq DOS system disk in drive A. 
There were no instructions as to which 
was drive A so I used an IBM-PC as my 
guide. The first rule with this system is 
— when in doubt about what to do, try 
copying your nearest IBM-PC. 

I switched on power and lo and be- 
hold a cursor appeared on the screen, 
then a message ‘‘testing memory’’ fol- 
lowed by some noises from the A drive 
followed by the MS-DOS opening mes- 
sages. If I discount the unpacking time 
and time checking with an IBM-PC to 
see how to connect things then it took 
me only about 10 minutes to assemble a 
working system. When I think back as 
to how long it took me to get my first 
S-100 CP/M system running, this was 
an absolutely pleasurable experience. I 
would put the assembly of the system 
almost at the level of assembling a hi-fi 
system. 

Here are some tips, if you decide to 
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follow in my footsteps. Drive A is the 
drive at the end of the cable (the cable 
contains the drive addressing rather 
than the select jumpers on the drive). 
Also, drive-A should have the termi- 
nating resistor pack. Be sure there is no 
resistor pack in drive B. 

Although the system ran im- 
mediately there were some problems. 
The display was 40 columns x 25 lines 
and I could not access drive B, when it 
was installed. The problems were 
caused by incorrect switch settings on 
the motherboard. Here again I used an 
IBM-PC as a reference. However, 
there are only half the number of 
switches on the Super Computer 
motherboard as there are on the IBM- 
PC. The PC has two groups of 8 switch- 
es (SWI and SW2) while the Super has 
only one group (SW1). A little experi- 
mentation proved that the Super’s SW1 
was the same as the PC’s SW1 and that 
SW? is really not needed. SW2 on the 
IBM-PC tells the system how much 
memory is in the system. The super 
computer tests memory and finds that 
out itself, so no need for SW2. I set the 
switches as if it were a PC and the 
display switched to 80 x 25 and I was 
able to access both drives. The installa- 
tion was complete! 


The Motherboard 

The motherboard appears to be 
built with about the same quality as 
IBM’s. It has 8 plug-in sockets, which 
is the same as an XT and 3 more than a 
PC. Since the unit has 8 sockets, 135 
Watt power supply (the PC has a 63 
Watt supply while the XT has 135W 
unit) and the BIOS ROM contains a 
hard disk boot, the manufacturer calls 
the unit the ‘‘Super XT’’. If you add the 
hard disk then the unit is really a copy 
of an XT rather than a PC. 

Physically, the unit looks very 
much like an IBM motherboard. There 
are the same number of ROM sockets 
and a socket for the 8087 math co- 
processor chip as well as a connector 
for a speaker. 


What's Different? 

When you look down inside the 
chassis you would swear you are look- 
ing at an IBM XT, that is how similar 
the unit is to the construction of the 
IBM-PC. However the case is a little 
larger in the depth allowing more room 
for routing the hard disk drive cables 
that are a real problem in an IBM box. 
No speaker was provided, but there is a 
mounting bracket and I intend (if I ever 
get a free minute) to run down to a 
Radio Shack store and pick up a minia- 
ture speaker. 

There were no instructions on how 
to assemble the cabinet. It took me 
about two hours to assemble it and get 
all the components installed. When I 


Micro/Systems Journal May/June 1985 


Instant-C': 
The Best Value 
In C Programming Tools 


The edit-compile-link-test-debug cycle that takes tens of minutes with 
compilers and linkers is only seconds with the /nstant-C interpreter. Yet it 
runs your programs 50 to 500 times faster than conventional C inter- 
preters! You get the best of both compilers and interpreters. Only /nstant- 
Cis acomplete, integrated environment for creating, testing, and running 


your programs. 


Instant-C gives you all of these proven capabilities in one tightly inte- 


grated package: 


interpreter—/nstant-C runs your programs faster than some compilers; 


has direct execution; full K&R 


compiler—/nstant-C can make stand-alone programs 
full-screen language editor—shows syntax errors with cursor set to 


trouble spot 


C source debugger—single-step, breakpoints, stack trace, more 
run-time checker— validates pointer refs, array bounds, more 

C source formatter—save editing time, find logical flaws 
standard library with source—for best portability 

linker—work with multiple source modules 

Lint—extensive compile-time validation 


The cheapest available examples of these tools would cost $800 (and 
they don't even work together). You could spend close to $3000 to get the 
best product of each kind, but you'd have ten times the complexity, filling 
megabytes of disk. /nstant-C is faster: it performs these functions 
automatically. /nstant-C is far more than the sum of its parts. 


Instant-C is all of these capabilities in one package, fits on a single floppy 
disk, is full K&R, works on IBM PC’s, compatibles, and others under DOS 


or CP/M-86. It costs only $495. 


Instant-C is the best value in C programming tools. Guaranteed, or your 
money back for any reason in first 31 days. 


Rational 


Systems, Inc. 


(617) 653-6194 
P.O. Box 480 
Natick, MA 01760 


Instant-C \s a trademark of Rational Systems, Inc. 


was finished I had two brackets left 
over and quite a few nuts, screws and 
washers. Apparently they were sup- 
posed to go somewhere but I couldn’t 
figure out where. Again, no assembly 
instructions were provided. 

There are sockets for ROMs, just as 
in the PC. However, there is only one 
ROM in the unit, the BIOS ROM. 
There are no Basic ROMs as in the PC. 
This means that the Basic interpreters 
(there are two) must reside on the disk. 
Therefore, the IBM versions of 
Microsoft Basic will not execute on this 
system since they use some of the IBM 
ROM Cassette Basic routines. The 
solution is to obtain a copy of the 
Microsoft version of disk basic (called 
GWBasic). The Compaq version of 


MS-DOS included the disk resident 
versions of Basic. 

Another thing that is different is 
that the BIOS memory test takes about 
2 seconds compared with upwards of 
30 seconds on the PC (more memory, 
more time). 


The Keyboard 

The organization of the keyboard is 
identical to that of the IBM-PC. It also 
included three LEDS that are lacking 
on the PC. There are LED indicators for 
power, caps lock, and number lock. 
This is a really neat feature. However, 
they glow so dimly that they are hard to 
tell whether they are on or off. 

The keyboard has a very different 
feel from that of the IBM. Although the 
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SERVO 8 HIGH PERFORMANCE 6 MHZ SINGLE BOARD COMPUTER 


6 MHZ Z80B CPU — RUNS AT FULL SPEED WITH NO WAIT STATES 
FOUR LAYER BOARD (5.75” x 8”) CAN MOUNT DIRECTLY TO MINIFLOPPY 
POWER REQUIRED 5 VOLTS AT 1.4 AMPS. NO OTHER VOLTAGES NEEDED 


UNIQUE FLOPPY CONTROLLER WITH AUTOMATIC SELF-ADJUSTMENT (NO POTS) 
FOR; 3.5” DRIVES, 5.25” DRIVES, 8” DRIVES, 1.6 MB 5.25” DRIVES 

CONFIGURATION MANAGEMENT UTILITY INCLUDED ALLOWS EASY MENU-DRIVEN 
SELECTION OF OVER 50 DIFFERENT FLOPPY AND WINCHESTER FORMATS AS 
WELL AS BAUD RATES, PRINTER PORT SELECTION AND TURN-KEY AUTOLOAD 


A &T SERVO 8 COMPUTER — $389 FOR CP/M ADD $70 
CP/M V2.2 CBIOS SOURCES — $50; INCLUDES WINCHESTER FORMATTER, 


S.A.S.1. (SCSI) BUS FOR WINCHESTER CONTROLLER (XEBEC 1410) 

TWO RS232 PORTS WITH SOFTWARE SELECTABLE RATES 300 TO 153.6K BAUD 
STANDARD CENTRONICS TYPE PARALLEL PRINTER PORT 

2K EPROM WITH AUTO SELECTION FOR BOOTSTRAP ( FLOPPY OR WINCHESTER) 
64K 150NS DYNAMIC RAM WITH 128K EXPANSION AVAILABLE 

50 PIN SYSTEM EXPANSION BUS WITH Z80 TERMS PLUS ADDITIONAL TERMS 
REAL TIME CLOCK, TENTHS OF SECONDS, SECONDS, MINUTES, DAYS, WEEKS 
NOT A TOY, SERVO USES MIL-SPEC OR INDUSTRIAL GRADE PREMIUM PARTS 


VISA M/C COD 


EPROM, CBIOS (Z80 CODE), CONFIGURATION UTILITY (TURBO PASCAL CODE) 


m SERVO EXPANSION BOARD WITH 128K ADDITIONAL RAM, CLOCK/CALENDAR 
WITH BATTERY BACKUP, TWO ADDITIONAL SERIAL PORTS, — $384 

@ SERVO CONTROL INTERFACE WITH 24 ANALOG INPUTS AND 8 ANALOG OUTPUTS 
(12 BIT ADC, DAC) PLUS 16 DIGITAL INPUTS, 64 DIGITAL OUTPUTS — $495 


[SERV o) 


SERVO COMPUTER CORPORATION 
360B N. ELLENSBURG ST. BOX 566 
GOLD BEACH, OREGON 97444 
(503) 247-2021 


feel is acceptable I find that of the PC 
preferable. The PC’s keys have more 
resistance and you have to press harder 
while the Super’s keys require very 
light pressure to make contact. 

There is also a little relay in the 
keyboard that makes clicking sounds 
every time a key is pressed or held 
down to repeat. This was probably 
done because the keys are very quiet 
compared to the IBM’s noisy keys. 
Fortunately, there is a control on the 
underside of the keyboard that allows 
one to turn off the clicking. 


Compatibility 


How compatible is the unit to that 
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of the IBM-PC? There are two software 
packages that the industry generally 
uses to test PC clone compatiblity... 
Lotus 1-2-3 and Microsoft’s Flight 
Simulator game. I can report that this 
units runs both without any problems. I 
also ran GWBasic with some rather 
large Basic programs that I have written 
and WordStar and can report no prob- 
lems with these either. If anything they 
seem to run a little better on this system 
than on the IBM-PC. First of all there is 
little of the screen flicker that is most 
annoying on the IBM-PC. And second, 
the half height floppy drives are much 
quieter and have a little faster read/ 
write times. 


Conclusions 

All in all, I think I made a wise 
investment. For an investment of about 
2-3 hours to assemble the system I 
saved about $1200 on the dual floppy 
system and well over $2,000 on the 
hard disk system. 


Board Sources 

Here are some mail order sources 
for foreign PC-compatible mother- 
boards, plug-in cards, keyboards and 
power supplies. Check them out care- 
fully as many are small outfits. 


American Digital Discount 
4040 Spencer St 

Torrance Commerce Center 
Torrance CA 90503 
(213)542-3578 


Computer Supply 

Box 164 

Valley Stream NY 11582 
(516)239-1855 


J C Computer Inc 
9238 Katella Ave 
Anahiem CA 92804 
(714)821-8922/23 


JDR Microdevices 
1224 S Bascom Ave 
San Jose CA 95128 
(800)538-5000 


Lanton Computer Systems 
37 Juneau Blvd 
Woodbury NY 11797 
(800)645-4441 


Mendelson Electronic Surplus 
340 East First St 

Dayton OH 45402 
(513)461-3525 


Micro Data Supplies 
22295 Euclid Ave 
Cleveland OH 44117 
(800)321-3552 


Microware Exceltak 

421 Grand Ave 

So San Francisco CA 94080 
(415)952-5375 


Super Price Inc 

25108 Margurite Parkway 
Mission Viejo CA 92691 
(714)730-9336 


The Great Salt Lake Computer Co 
Inc 

1780 W 2300 South 

Salt Lake City UT 84119 
(800)545-2633 


United Computer Resources 
931 Arch St 

Philadelphia PA 19107 
(215)849-0589 
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LOMAS DATA PRODUCTS INVITES YOU TO: 


SHARE THE THUNDER. 


The $100-PC-TM offers the 
following standard features: 
| High performance THUNDER186 8Mhz 


80186 processor 
] 512K bytes of RAM (expandable to 1Mbyte) 


(1 4 serial ports to support up to four users 


3 Centronics compatible parallel ports 


Sone 


Concurrent DOS operating system 


allows execution of both CP/M-86 and < 


MS-DOS (PC-DOS) programs \ 
| 5%" IBM-PC compatible floppy drive | ' 
(1 40 Mbyte high performance Winchester drive ‘x’ 
|] Attractive 10 slot desktop enclosure a 
In addition, a number of options are available Qing: 
larger Winchester drives, more user ports, 80286. proces- 
sor, graphics support and additional operating systems 
(MS-DOS and CP/M-86). 


$100 BUS boards products & support 
for the system integrator... 


All of LDP boards are fully tested to exacting standards 
and carry a one year warranty. We specialize in 16-bit 
products & support the major operating systems for 16-bit 
processors: CP/M-86*, CONCURRENT CP/M-86*, and 
MS-DOS (PC-DOS). 


@ THUNDER186 — THE ONLY COMPLETE S100 BUS, 
16 BIT SINGLE BOARD COMPUTER AVAILABLE 
TODAY. 

Concurrent CP/M-86, which in addition to running CP/M-86 
programs, runs MS-DOS programs. Comes complete, 
ready to plug into an enclosure and min. 256K bytes of 
TSC/ANW (Co 101 ha oa tg a en anne ara Fp PRICE $1595.00 


@ LIGHTNING ONE***8086/8088 CPU 
8086 or 8088, with 8087 and 8089 coprocessors. Up to 10 
MHZ operation .............. PRICES start at $425.00 


@ HAZITALL SYSTEM SUPPORT BOARD 
2 serial, 2 parallel ports, battery protected clock calendar. 
Hard disk controller host interface ...... PRICE $325.00 


@ LDP 128/256K DYNAMIC RAM 
Advanced dynamic RAM with LSI controller for failsafe 
operation, parity . . PRICE 128K—$395.00, 256K$649.00 


@ RAMG67 HIGH PERFORMANCE STATIC RAM 
High speed (100ns) low power CMOS static RAM. 128K 
bytes, extended addressing ........... PRICE $995.00 


@ LDP72 FLOPPY DISK CONTROLLER 
Single/double density, single/double sided disks, both 8” 
and 5%" inch drives simultaneously..... PRICE $275.00 


@ LIGHTNING 286—80286 CPU BOARD 
Offers 4 times the performance of a 5MHZ 8086 CPU while 
maintaining software compatibility ..... PRICE $1095.00 


@ OCTAPORT 8 PORT SERIAL BOARD 
0 to 19200 baud operation real time clock interrupt. Ideal 
for multi-user systems such as MP/M-86* PRICE $395.00 


S100-PC-TM is a trademark of Lomas Data Products, Inc. 

*CP/M-86, MP/M-86 and CONCURRENT CP/M-86 are trademarks of 
Digital Research. | **MS-DOS is trademark of Microsoft. 
**kLightning One is trademark of Lomas Data Products, Inc. 
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$100-PC-TM: The LDP 
Multi-user $100 Bus System 
offers high performance at 
a “low” price . . . plus, 
‘“‘our’’ system is expandable 
and upgradeable! 


$6995°° 


PRICE 
An unbelievable 
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DP 


LOMAS DATA PRODUCTS, INC. 
66 Hopkinton road, Westboro, MA 01581 
Tel: (617) 366-6434 | | Telex: 4996272 


Dealer inquiries invited. 


For orders outside the U.S., contact 
our exclusive dealers: | | Australia — 
LAMRON PTY. LTD., (02) 85-6228 

|| Malaysia — EXA COMPUTER (M) 
SENDIRIAN BERHAD, 795284 


Super assemblers 


pius the world’s 
largest selection of 


cross assemblers! 


All 2500AD 
Assemblers and 
Cross Assemblers 
support the following 
features: 


POWERFUL LINKER 

—Links up to 128 files 

—Allows files to be used just for 
external reference resolution 

—Separate code and data space 

—Unlimited global and external 
symbols 

—10 significant characters per 
symbol, no limit to length 

—Submit or batch mode as well as 
command invocation, for easier 
linking of a large number of files 


ASSEMBLER DIRECTIVES 
Storage Control: 
* ORG, ORIGIN 
«END 
-DB, DEFB, BYTE, STRING 
DW, DEFW, WORD 
* LWORD, LONGW 
* ASCII 
«DS, DEFS, BLKB 
* BLKW 


Definition Control: 

* EQU, EQUAL 

* VAR, DEFL 

* MACRO 

*ENDM, MACEND 

* MACEXIT 

* EXTERN, EXTERNAL 
* GLOBAL, PUBLIC 
«ASK 


Assembly Mode: 

* RADIX 

*DATA 

* CODE 

* MOD32 ON & OFF 
* COMMENT 

* INCLUDE 
*DRIVES 


Conditional Assembly: 
°IFZ, IFNZ, COND 
¢ IFTRUE, IFFALSE 
° IFDEF, IFNDEF 
¢IFSAME, IFDIFF 
¢ IFEXT, IFNEXT 
*IFABS, IFREL 
*IFMA, IFNMA 
*ELSE 
* ENDC, ENDIFT 
*IFCLEAR 
Listing Control: 
«LIST ON/OFF 
* MACLIST ON/OFF 
* CONDLIST ON/OFF 
*PASS1 ON/OFF 
* PAGE, EJECT 
* TITLE, HEADING 
* SUBTITLE 
“PW 
*PL 
«TOP 
Additional Motorola Directives: 
*FCC 
* SET, SETDP 

G 


«NAM 
°STTL 
* XDEF 
° XREF 
*FCB, FDB, RMB 
*LONG 
Run time commands (invoked 
while assembly is in progress): 
“S—Alternately start and stop 
assembly 
*“C—Terminate assembly 
“T—Display output at terminal 
*P—Display output at printer 
“*D—Send output to disk 
“B—Both terminal and printer 
or disk 
“N—Turn off output display 


1 Year of free support and 
updates now included! 

You will receive a special support 
phone number on all products 
purchased after 3/1/85 allowing free 
updates and a full 12 months of 


support, included in the purchase 
price. 


Features unique to 
these 2500AD 
products: 


6800 FAMILY —“S’-record output 
option, special directives for dealing 
with page zero, absolute or 
relocatable modes. 
68000—“S’-record output option, 
S-19, S-28 and S-37. 

65XX FAMILY —Special directives 
for dealing with page zero. 

Z-8— Register naming supported, 
TEK HEX output format. 
8748—Register naming 
supported, INTEL HEX output. 


8051/44—Register naming 
supported, INTEL HEX output. 


8096—Register naming 
supported, INTEL HEX output, 
works for the 8097 as well. 
“Generic” calls and jumps allow 
assembler to determine long or 
short jumps. 


Z-8000—Includes 8080/Z-80 to 
Z-8000 source code translator, 
uses the 2500AD syntax, not 
source compatible with Zilog. 
Includes powerful segmented linker. 


Z-80—Includes an Intel 8080 to 
Zilog Z-80 source code converter. 
Includes the 2500AD linker, not 
compatible with Microsoft at the 
link level. 


8086/88 & 80186— Includes an 
8080/Z-80 to 8086 source code 
translator that will convert 8080/ 
Z-80 source code to 8086/88 
source code. Includes linker, not 
link compatible with Microsoft. 
Code, Data, Stack, and Extra 
segments supported. 


ZILOG OLIVETTI 


YADSCFIVARE INC 


| 
| 
MPC M-20 
t Z80 SYSTEM 8000 IBMPC IB 
CP/M® UNIX MSDOS CP/M 86 PCOS 
| 
| 
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™ 750.00 $299.50 $299.50 $ 
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oe ne ee ne nee: 
; . . . 
ey fone 500.00 199.50 199.50 199.50 
E eann 0.00 199.50 199.50 199.50 
'  8400/84C00 199.50 50 ane 
C351 199.50 500.00 199.50 199.50 199. 
i Baaaie 199.50 500.00 199.50 199.50 199.50 
b eo 199.50 500.00 199.50 199.50 199.50 
Se 500.00 199.50 199.50 199.50 
b Gone ‘eed 9.50 199.50 199.50 
t 8096 199.50 500.00 199. ipea0 jona0 
' 68020 399.50 750.00 399.50 pe ee 
t  68000,08,10 299.50 750.00 e050 ee 
i —6800,02,08 199.50 500.00 99.50 199.50 199.50 
t+ 6801,03 199.50 500.00 psa ae ee 
ee (SDE SOeDe 199.50 199.50 499.50 
. teks 500.00 199.50 199.50 199.50 
' 6809 199.50 ae ieee 
t  68C11new 199.50 500.00 199.50 199. o ee 
i 32000 399.50 750.00 e030 an oe 
H 0.00 199. ' 

COPS400 199.50 50 ie 
NSC800 199.50 500.00 199.50 da 0 = 
' 6301 199.50 500.00 199.50 128-80 i9e:60 
i new 199.50 500.00 199.50 
B esoi/ 199.50 199.50 199.50 
i 6501/14 199.50 500.00 ae igh.50 joes 
ou eae Bona fan 199.50 199.50 
1 199.50 ; 
oon . 199.50 500.00 e380 en ae 
i 199.50 500.00 
i NECTSe0 199.50 500.00 199.50 i soe) : > 
i _NCR/32 399.50 750.00 399.50 
| 

$ 

Subtotal $ $ $ $ 
' . . 
i TO ORDER. Simply circle the product or 
be products you want in the price columns, and add 
Se up your order. Total § 
i State Zip Check one: Shipping UPS Blue 
| as 8" Single Label no charge, 
Bee _] Osborne $20.00 shipping for, 
Maho ene mgs avon eernp met (| IBM PC International per unit. 
ce = Gate tape 

a e (Softc 
! [| COD (2500AD pays COD charges) ] ad panteas <siubGudars 
eile other formats available, please call! 
: Number 
; Expiration Date Signature 
i 
1 
| 
| 
| 
| 
1 
1 
L 


ZCPR3 


A CP/M-80 V2.2 
Enhancement 


by Randy Reitz 


A brief history of ZCPR 

ZCPR3 is the latest installment in 
the ZCPR series of CP/M 2.2 enhance- 
ments. ZCPR3 is the work of Richard 
Conn. He was one of the group of ori- 
ginal developers of ZCPR. Back in 
1980 ZCPR was put in to the public 
domain as a replacement for the CP/M 
Console Command Processor (CCP). 
CP/M 2.2 provided a way to divide up 
mass storage into areas identified by 
“‘user’’? numbers. You make use of this 
feature and enter a user area with the 
USER command. That’s fine. The 
problem is now when you type a com- 
mand, the CP/M 2.2 CCP looks only in 
the current user area of the disk for the 
command.COM file. This is incredibly 
dumb. ZCPR fixed this deficiency and 
added some more useful resident com- 
mands to the bargain (since it is written 
in Z80 assembly language, more code 
can be packed into the 2k-bytes of 
space alloted for the CCP). ZCPR be- 
came an instant success. I don’t know 
of many CP/M 2.2 systems that don’t 
have ZCPR running. 

Richard Conn offered ZCPR2 
sometime in 1981/1982 and improved 
on ZCPR slightly. ZCPR2 offered the 
option of naming the disk/user-number 
combinations so that they became even 
more convenient to use. ZCPR2 re- 
quired more memory than the 2k-bytes 
available in the CCP so it required that 
the CP/M 2.2 system be moved down to 
make room available above the system. 
This sufficiently complicated the in- 
stallation procedure so that many peo- 
ple decide not to convert since the be- 
nefit gained did not offset the pain of 
installation. 

Now Richard is offering ZCPR3. 
Again, to his credit, ZCPR3 is in the 
public domain (for private use, not to 
be resold) via SIG/M. It can be found 
on RCP/M systems and in computer 
club software libraries. ZCPR3 retains 
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A CP/M-80 CCP 
replacement and 
how you go about 
installing it. 


all the good features of its predecessors 
and adds considerably more features by 
way of a cooperating set of utilities and 
application development tools. ZCPR3 
is also commercial. Echelon, Inc., 101 
First Street, Los Altos, CA 94022 is 
marketing ZCPR3 and utility packages, 
documentation and some of Conn’s 
other software (e.g., his SYSLIB3, 
VLIB, Z3LIB, and Discat packages. 
Echelon also sells a complete line of 
assembly language software develop- 
ment programs including relocating 
macro assembler with linker and libra- 
rian, five code translators, two debug- 
gers, and disassembler.) 

Echelon provides support to 
ZCPR3 users that purchase the soft- 
ware from them. They offer telephone 
consultation and a fortnighter newslet- 
ter. The newsletters (called Z-News) 
offer tips on ZCPR3 installation and 
usage as well as ‘*8-bit versus 16-bit’’ 
editorials. For example, newsletter 004 
contains a ‘‘Note about value’’ that 
concludes ZCPR3 is a real bargain 
since it cost only $.0001 per byte versus 
Unix at $.03 per byte. This information 
is useful for folks who buy software by 
the byte; but such logic makes me skip 
the editorials and hype and just read the 
technical tips. The tips are useful, espe- 
cially the installation and utility usage 
tips. 


What is ZCPR3? 
ZCPR3 has gone beyond a simple 


CP/M 2.2 CCP replacement. By virtue 
of a reserved ‘‘message’’ area above 
the BIOS, ZCPR3 arranges to have its 
over 70 utilities interact with each other 
and the operating system to produce an 
environment that is greater than the 
sum of its parts. Many of the utilities 
are screen-oriented so that along with 
the menu capabilities of ZCPR3’s 
shells, very friendly interfaces can be 
developed (as demonstrated by the uti- 
lities MU3, DU3, SHOW, MENU, 
VMENU and VFILER). The space 
above the BIOS is also used to hold the 
system segments — areas designated 
for special purpose programs such as an 
RCP (Resident Command Processor), 
NDR (Named Directory file)., FCP 
(Flow Control Processor) and an IOP 
(Input/Output Package). All these pro- 
cessors and the features they contain 
are optional and extensively optioned. 
A ‘‘full’’ implementation of ZCPR3 re- 
quires 5k-bytes of space above the 
BIOS. This sounds like a lot to take 
away from a 64k-byte system; but con- 
sidering that only a few CP/M 2.2 ap- 
plication programs make use of all of 
the available space, it isn’t much for the 
capability it brings. 

8080/8085 users note that ZCPR3 
can be assembled to run on an 8080 or 
8085 processor. Fewer features can be 
packed in since the 8080/8085 code is 
not as compact as the Z80. Most of the 
utilities can be assembled for 8080/ 
8085 or Z80 via an equate that permits 
assembly using either Z80 or 8080 in- 
structions. 


Documentation 

I received a copy of the preliminary 
documentation with ZCPR3. The 
ZCPR3 ‘‘Sampler’’ is credited to Mr. 
Conn and the staff of Echelon. It con- 
tains two major sections, the ZCPR3 
Installation Manual and examples cal- 
led a User’s Perspective. 
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The Installation Manual weighs in 
at 121 pages. I am sure I could describe 
just the ZCPR3 installation in a lot less 
than 121 pages; but this installation 
manual includes detailed descriptions 
of all available options. This situation 
is OK, even commendable, but the 
organization of the manual is poor. The 
ZCPR3 Newsletter 003 details an in- 
stallation procedure that isn’t as clut- 
tered with detail. My reaction to the 
installation manual was that it tried to 
give you all the information on the 
numerous options before installation 
begins. 

At least 3 hours of reading is re- 
quired to get an appreciation of what 
was needed to install ZCPR3. I spent 
another 3 hours with the BIOS mod- 
ifications and other installation activi- 
ties. The critical BIOS modifications 
were presented by way of excerpts from 
a working BIOS. This requires the 
reader to understand what the excerpts 
are doing, ignore the extraneous code, 
symbols and decide how the excerpts 
should be incorporated into his own 
BIOS. Not an easy task! 

The other section is called a ‘‘US- 
ER’S PERSPECTIVE”’. This docu- 
ment is by Mr. Conn and is a collection 
of sample terminal sessions that illus- 
trate the major features of ZCPR3. I 
found this document useful. You can 
try the examples with your working 
ZCPR3 system. This is a good way to 
learn its features. This section is 41 
pages. The complete ‘‘ZCPR3: The 
Manual” is in the works. It promises to 
be ‘‘lavish, typeset and over 300 
pages.”’ 


Installing ZCPR3 

Steps outlined in ZCPR3 ‘‘Sam- 
pler’’ contain too much detail concern- 
ing the multitude of options available. 
A user will likely be interested in this 
detail only after ZCPR3 is installed and 
some working experience is gained. A 
much simpler step-by-step procedure 
that produces a ‘‘standard’’ configura- 
tion could be used. A memory layout is 
proposed as well as all of the options 
have default values in the .LIB files. A 
generic modification to an existing 
BIOS could be developed that would 
not require access to the source code of 
the existing BIOS. Echelon offers an 
auto-install version of ZCPR3 called 
Z3-Dot-Com, as well as full CP/M 2.2 
replacements called Z-Com and Z- 
System. 

After some study, I decided to 
accept the memory layout for the max- 
imum installation that is supplied in file 
Z3BASE1.LIB. I renamed this file to 
Z3BASE.LIB. The Installation Manual 
section spends 7 pages describing this 
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ZCPR3 BIOS 


Figure 1 


file’s contents. Next, the default op- 
tions in Z3HDRI1.LIB are fine. I re- 
named this file to Z3HDR.LIB. The 
Installation Manual section spends 14 
pages describing this file’s contents. So 
here are 21 pages you look at before 
you realize that it can be skipped for 
later appreciation. 

Once the Z3BASE.LIB and 
Z3HDR.LIB files are defined, you are 
ready to assemble the ZCPR3.ASM 
file. This is as simple as entering one 
MAC command. The problem is that 
this command is described in section 
4.5.9 while the procedure to overlay 
the old BIOS and CCP is mentioned in 
section 4.3. That is two — sub- 
sections before the ZCPR3.ASM file is 
assembled. This lack of good organiza- 
tion in the Installation Manual as well 
as those infernal X.X.X section num- 
bers just serves to add unnecessary 
complication to the installation pro- 
cess. 

With ZCPR3.HEX created, you are 
now ready to work on the BIOS mod- 
ifications. The reason that this is re- 
quired is that ZCPR3 expects to find 
initializing information in the ‘‘system 
segments’ areas of memory when it 
first comes up. The only easy way to do 
this is to initialize these areas in the cold 
boot BIOS code. As I mentioned, ex- 
cerpts from a modified BIOS are shown 
in the installation manual. These ex- 
cerpts cover 15 pages (the code is 
heavily commented). 

I chose to proceed as if I did not 
have access to my BIOS source code. 
The memory layout specified in 
Z3BASE.LIB provide 3.5k-bytes for 
the BIOS. Since the BIOS I use takes 
less than 3k-bytes, I decide to use the 
0.5k-bytes at the end of the BIOS as 
patch space. I typed in the cold boot 
code presented in the excerpts and 
assembled it to run at the patch address. 
In the patch procedure to overlay the 


CCP and BIOS, I read the cold boot 
patches into the proper proper and then 
patched the cold boot at the start of the 
BIOS to use the new cold boot code. At 
the end of the cold boot code, I patched 
a jump to the original cold boot code. 
This can be illustrated in Figure 1. 


I think this method is sufficient to 
get started. The only feature not sup- 
ported is character I/O redirection. 
Since I have not implemented an IOP 
(I/O Processor segment), I didn’t mind. 
The BIOS modifications required to 
implement I/O redirection are not men- 
tioned in the text; they have to be done. 
gleaned from the listing excerpt, The 
details of writing an IOP are not in- 
cluded in the installation manual (they 
shouldn’t be included). I suspect the 
full manual will elaborate. 

By this point, with the 
ZCPR3.HEX and CBIOSZ.HEX files 
available, you are ready to patch the 
system image. The system’s size may 
first have to be adjusted to match the 
memory data in Z3BASE.LIB. The 
patching steps require that the system 
image be obtained with SYSGEN, 
saved to a file, this file loaded with 
DDT or SID, the two HEX files above 
patch in with the proper offsets (i.e., 
you have to know where your SYSGEN 
puts the CCP, BDOS, and BIOS in the 
system image), the patched image saved 
to a file and finally SYSGEN run to get 
the patched image on the system tracks 
of the disk. This is the kind of stuff 
books are written about. Anybody who 
has done this remembers it well, the 
others probably don’t want to attempt 
it. But it’s not quite as bad as it sounds. 
The ZCPR3 installation manual takes a 
good crack at an explanation by way of 
an example ‘‘patching’’ session. It can 
be done.Gather your system’s facts and 
study the example — and maybe buy an 
‘*All you ever wanted to know about 
CP/M”’ type book. 
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Z sets you FREE! 


Z — yes! Synergistic combination of ZCPR3 and ZRDOS2 produces 
flexible state-of-the-art Z80 operating system with tremendous produc- 
tivity features. 


Z-System consists of software modules, dynamic loading segments, 
and tools permitting optimum computer usage ranging from produc- 
tion program development to turnkey, password-controlled, end-user 
installations. Facilities include: multiple commands per line, file search 
paths, named directories, |/O redirection, command flow control, 
screen-oriented menu generators, complete housekeeping file and 
directory management, shells, alias (scripts) and nested-alias genera- 
tion, and complete online help. 

Seventy-six support utilities, five tool packages, and two application 
programs available now! Fully upward compatible with CP/M-80. 

Z can now be purchased as auto-install program (Z-Com) or as 
manual-install ZCPR3 with semi-auto install ZRDOS package (Z- 
System). Our latest versions, to be released this year, support Zilog 
Z800 and Hitachi HD62801/64180 high-technology chips, chips run 
existing 8080 and Z80 programs! 

Echelon eight-bit operating systems written in Assembly Language, 
using linkable macro subroutine libraries, offer performance parallel- 
ing best single-user 16/32-bit microcomputer systems. 


1. Z-Com Full-up Z Operating System with input/output redirection 
running under CP/M-80, online command and utility documentation 
and help:system: wie he. aw nc Lies cenmhecg bits oe ae $219.95 


2. Z-System Manual-install ZCPR3 and ZRDOS2, easily tailored by 
programmer to custom needs; source code to core and utilities; similar 
to Item 1 


mem wwe eww ee meee ener e rere reer eeeereeesereseee 


3. Z-Tools Four software development system packages permitting 
advanced, structured program design, macro relocating assembler, 
linking loader, librarian, cross-reference generator, debugger, mne- 
monic and pseudo-op translators, and interactive disassembler. Super 
$3115.00: package ValUes< scscs acute 'ons se eis inronssaral ole ego nee. oyotsintsaiar® $200.00 


4. DSD Dynamic Screen Debugger offers high-level features never 
before found in microcomputers; simultaneous display of dual-memory 
segments, stack, cpu states, and flags, with software In-Circuit- 
Emulation fcssicccs oss canes Ue ecen dase soe ee eae $149.00 


5. The Libraries Linkable ZCPR3 libraries (Vlib, Z3lib, and Syslib3) 
of over 400 subroutines used for Assembly Language program writing. 
Simplifies structured, efficient code production; online help system 
and full source code provided ..........ccecee cece ee cece $45.00 
SyslibS alone. c.io os oinkes coc Se nae hs o Wig woe Gee viene wa ea $29.00 


6. Term3 New generation communication program permits menu 
control of computer/modem operations between operator and time- 
share services, bulletin-boards and other remote computer systems; 


auto-answer to command-line prompt .............eeeeee- $99.00 
7. Discat Fancy file and disk catalog program running under Z- 
System, menu driven and easily customized by operator ..... $49.00 


Fortnighter newsletter, 24-hour BBS Z-Node System keep Z users 
informed of microcomputer happenings. Write or call for brochure or 
order now! State disk format desired; add $3.00 shipping & handling; 
Californians please add 6-1/2% sales tax. Visa/MC, check, money or 
purchase order accepted. (Program names are trademarks of their 
respective owners.) 


Echelon, Inc. 


101 First Street e Los Altos, California 94022 e 415/948-3820 


Now you can boot up ZCPR3. 
When I did I found that I didn’t have a 
DIR command. (What’s the first thing 
to try after booting a new system?) The 
Z3HDR.LIB file had specified that the 
DIR command not be resident. Rather 
an RCP (Resident Command Proces- 
sor) segment could provide DIR or one 
of the may directory transients (utili- 
ties) supplied could be used. 

I proceeded to assemble the system 
segments for the environment, named 
directories, resident command proces- 
sor and flow control processor. Each of 
these assemblies uses an .ASM and 
corresponding .LIB file. The .LIB files 
contains more options that the installa- 
tion manual details in 22 pages. As 
before, I chose to go with the examples 
or defaults supplied. I skipped the IOP 
segment since this needs to be custo- 
mized to conform to your particular 
system’s I/O. Finally, I selected my 
terminal from a list supplied by running 
the TCSELECT command. This pro- 
vides the information needed for the 
screen-oriented utilities. These system 
segments (including the terminal de- 
scription) are loaded into their proper 
locations above the BIOS with the LDR 
command. This has to be done once 
after each cold boot; but the LDR and 
other commands can be put into one 
alias file and automatically executed on 
cold boot. 

The final installation step is to run 
the Z3INS program that installs the sys- 
tem’s environment description into 
each utility program’s code. This is 
simple since a file containing a list of 
the installable utilities is provided as 
one argument to the Z3INS command. 
The other argument is the system’s en- 
vironment file SYS.ENV that was cre- 
ated by the assembly of the environ- 
ment segment program. 

By putting all of the system seg- 
ment files and utilities on one disk, you 
can generate a ZCPR3 system disk. 
Now all of the features of ZCPR3 are 
available. 


Major features 

1. DIRECTORIES: In effect, the CP/M 
2.2 disk/user concept is allowed to be 
named. This makes the disk/user idea 
more useful, but it’s not a Unix or MS- 
DOS directory. It’s flat, not hierarchic- 
al, i.e., you.can’t have a directory as 
the contents of another directory. (ed 
note: by using the CD, change direc- 
tory, command which auto-loads ST, 
start alias, a new named directory is 
loaded permitting hierarchical, struc- 
tured disk directories. New directories 
are created using MKDIR utility com- 
mand.) I have never used the DU fea- 


ture, who can remember what is in user 
5 versus user 13. But if disk A: user 5 is 
called HELP: and disk A: user 13: is 
called ROOT:, I can remember what’s 
there and I will use the DU feature by 
using named directories. This is great. 
CP/M Plus could use the named direc- 
tory idea since it suffers from the same 
unfriendly user numbers. Another good 
feature of named directories is their use 
can be password protected. 


2. COMMAND LINES: Multiple com- 
mands per line are provided. This same 
Unix shell delimiter ‘;’ is used. CP/M 
Plus has this, but with a different de- 
limiter. One missed feature of CP/M 
Plus is command line editing. Once you 
hit the RETURN key and send a com- 
mand line off to ZCPR3, if an error 
occurs due to a typo, you will have to 
retype the whole line (ed note: using 
one of the ZCPR3 error handlers, any 
single command can be re-entered 
without changing any other in the line). 


3. COMMAND PROCESSING — THE 
PATH: Command search paths can be 
specified. This is the old (original) 
ZCPR feature made better. The search 
path can be modified at any time. 

A flow control package can be used 
if one is installed. The FCP can be 
changed at any time. This means logic 
can be put into command files that can 
control the flow of command execu- 
tion. This doesn’t work very smoothly 
in CP/M 2.2 since commands (except 
ZCPR3 utilities) don’t return status 
codes. CP/M Plus has rudimentary sta- 
tus return checking. So in ZCPR3, the 
command files have lines like: 


IF INPUT Type N or F to ABORT if Errors Exist 


that solicit terminal input. 
Resident Command Packages can 


be added to give fast built in commands. 


like CP. You:canihaveseveral RCPs and 
change them at any time. The H com- 
mand will always list the available RCP 
commands. 

The command processing search al- 
ways ends with either an error handler 
or ‘‘extended’’ command processor. 
The error handler may default to simple 
? or a sophisticated screen-oriented 
menu error handler (several are sup- 
plied) may be used. I did not try the 
extended command processor; but it 
seems to be an opportunity to have a 
command processor like ZEX take over 
if all else fails. One penalty for this 
extensive search path is speed. The disk 
can grind while all of the possibilities 
are checked. 


4. ALIASES: This is a clever idea that 
provides easy to develop command(s) 


packages, Parameter passing is sup- 
ported as with SUBMIT. This is like a 
macro preprocessor for command 
lines. The ALIAS command solicits 
command lines and produces a .COM 
type file, hence the resulting file 
doesn’t need any command interpreter 
to run. aliases is useful for defining the 
STARTUP (at cold boot) command. 


5. SHELLS: ZCPR3 shells are front- 
ends that provide a different user inter- 
face in place of the normal ZCPR3 
prompt. Several ‘‘menu’’ shells are 
provided that can be used to display a 
user written set of menus, accept input 
and execute the appropriate com- 
mands. A general purpose SH shell is 
provided that supports variable sup- 
port. 


6. Z3TCAP: This is the ZCPR3 TCAP 
(Terminal Capability) utility that 
allows ZCPR3 to have easily modified 
screen-oriented utilities. The 
TCSELECT program allows a selec- 
tion to be made of any of many (ed note: 
presently 56) predefined terminals and 
packaged computers. TCMAKE 
allows terminals and computers not 
already supported to be added. 


7. SECURE SYSTEMS: ZCPR3 offers 
password protection for selected com- 
mand and named directories. With the 
DU form disabled, a secure environ- 
ment can be defined. The directories 
that a user can access are the ones 
whose name is know, and some of these 
may be password protected. 


Conclusion 

This covers the major features of 
ZCPR3. As far as some limitations that 
I see, the reduced size of the TPA re- 
quired to supply ZCPR3 with its buffers 
and such is no big deal. All of the 
ZCPR3 utilities require a lot of disk 
space. A double density 8-inch floppy 
(500k-byte capacity) can barely handle 
it. Double sided 8-inch (1 megabyte) 
floppy will do it. A hard disk would be 
a big help. An Echelon newsletter 
points out that hard disk storage is 
cheaper than RAM (the problem is that 
you have to buy so much of the hard 
disk storage, i.e. 10 megabytes or 
more). 

For the price, the utility of ZCPR3 
is a bargain. The utilities represent the 
best of the public domain stuff plus the 
screen-oriented versions of these utili- 
ties make them very easy to use. The 
installation problems can be made 
easier for the do-it-yourself types, and 
the auto-install versions from Echelon 
should allow ZCPR3 (ed note: and also 
the Z-System) to reach commercial and 
casual users. 


JOHN D. OWENS ASSOCIATES JOHN D. OWENS 


LARGE 


DISCOUNTS FROM 
JOHN D. 


OWENS 


ASSOCIATES 


MACROTECH MI-286: 80286/Z-80H 
DUAL PROCESSOR S-100 CPU 
BOARD: ...$876 MSR RAM: 120NS, 
high-speed dynamic RAM, Works with 
CompuPro 8085/8088; MI-286 and others: 
256K .. $556 512K... $716 STATIC 
RAM: Substitute for RAM 22 and RAM 23: 
256K STATIC: ...............0.. $960 
SIQK STATIC? . occ wsswaeaes $1,800 


EMERALD SYSTEMS HARD DISK 
and TAPE SUBSYSTEMS 

High capacity! Up to 280 MB! Emerald has 
overcome the 32MB DOS limitation! Mul- 
tiple volumes per physical drive. Back up 
and restore utilities. 


HOUSTON INSTRUMENTS: Pict- 

ters: DMP 41 OR 42:.. $2,397, DMP 29: 

... $1,838 DIGITIZERS: DT11.. $694; 
$750; DT1l1AA 

New! 14 pen DMP 51 and 52: ... $4,796 


ILLUMINATED TECHNOLOGY 
$1,116 


NEC APC III: 80816 MS-DOS system w/ 
20% off list 


S-100IMB: .. $1,472 S-1002MB:.. $2,091 


LOMAS: 80286, CCP/M and MS-DOS S- 
100 Systems with COLOR GRAPHICS for 
IBM-PC compatibility. 


RACTER: Interactive conversational 
software for IBM-PC. Jan 1985 Scientific 
American called RACTER, “... extremely 
funny.” RACTER is light years ahead of 

Bia io: cesarcenpsrteavenas donde Ae ROE $69.95. 


MIST + CONEXUS: Integrated 
software for IBM-PC combining telecom- 
munications, text processing, data base 
management. 


BIG DISCOUNTS on COMPUPRO, 
IMS, BYAD, many others. Prices & avail- 
ability subject to change without notice. 


WRITE OR CALL FOR PRODUCT LITERATURE. 


WE EXPORT: Overseas Callers: TWX 710 
588 2844 (OWENSASSOC NYK). EASY 
LINK MAILBOX ADDRESS: 62840 768. 


ORDER BY PHONE, LETTER, TELEX OR EASY 
LINK. We accept VISA and Mastercard. Ship- 
ping $5 per board in continental USA. 


JOHN D. OWENS 


ASSOCIATES 
12 SCHUBERT STREET 
STATEN ISLAND, N.Y. 10305 
(718) 448 6283 (718) 448 6298 
(718) 448 2913 


JOHN D. OWENS ASSOCIATES JOHN D. OWENS & 
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C And The Godbout Disk 1 
Controller 


by Edward Heyman 


In his article in the 1982 September/ 
October Microsystems Anthony 
Skjellum made the point that the C pro- 
graming language is a viable alternative 
to assembly language for utility pro- 
grams. My experience is that C not only 
reduces the time required to develop 
correct programs versus assembly lan- 
guage, it also makes it simpler to write 
programs that are ‘‘user friendly’’. 
This article discusses a practical exam- 
ple of the use of C to write disk utility 
programs. It also provides some insight 
into the operation of the Intel 8272 con- 
troller chip and the Godbout Disk1 con- 
troller board as well as providing sever- 
al useful utilities and a command lan- 
guage to use to create your own utili- 
ties. 

Although some of the utilities could 
be written with calls to the CP/M 
BDOS or BIOS, directly accessing the 
controller lets you use faster and more 
powerful commands. For example, en- 
tire cylinder reads and writes may be 
done. Also there are no provisions in 
the CP/M BDOS or any BIOS that I 
have seen, to format a disk. 


The Objectives 

I recently upgraded my S-100 sys- 
tem with a Godbout Disk! DMA con- 
troller and Qume double sided eight 
inch drives. Although Godbout sup- 
plies a format and a Copy program, | 
wanted to be able to format individual 
tracks, to verify a disk and locate any 
bad sectors and I wanted a faster copy 
program. I also use the UCSD ‘p’ sys- 
tem and needed some utilities for spe- 
cial disk formatting and system genera- 
tion. However my most important 
objective was to understand how the 
controller worked. 


The Strategy 

The first step was to read the 
Godbout and Intel literature in the 
Disk1 manual. This literature was very 
helpful but, as I was to learn, did not 
tell the whole story. I then wrote 
routines to implement simple disk op- 
erations, placing the routines in a pro- 
gram that let me test their operation. I 
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used a lot of printf() statements so that I 
could trace the progress of the program 
and understand what the controller was 
doing. Once a routine was shown to be 
correct I placed it in a library and pro- 
ceeded to the next routine. 

When the library contained all the 
primitive disk routines I began a second 
library that contains more powerful 
disk commands based on the disk 
primitives. Once the second library was 
complete writing the utilities was a sim- 
ple task. 


The Hardware 

The Disk1 board uses the Intel 8272 
/ NEC 765 disk controller chip. The C 
routines that I developed are ap- 
plicable, with some modifications, to 
other boards using this chip. 

Communication between the CPU 
and the Disk1 is done through three IO 
ports. Two of these ports are for the 
8272 chip and the third is implemented 
on the Disk1 board. The ports are as 
follows: 


DISK1 CONTROL PORT FUNCTION 


PORT NAME PORT FUNCTION 

READ WRITE 
FD_STATUS — CHIP STATUS REGISTER 
FD_DATA RESULTS DATA COMMAND DATA 
DISKI_PORT BOARD INTERRUPT STATUS = DMA ADDRESS 


Each command to the disk control- 
ler has a command phase, an execution 
phase and a result phase. During the 
command phase, a series of bytes is 
sent to the controller data port. When 
the controller receives the last byte of 
the command, it enters the execution 
phase. When execution is complete the 
interrupt status is set and the result data 
bytes must be read by the cpu from the 
fd_data port. The major commands that 
the 8272 chip understands are: 


Number of 

command result 

Command bytes bytes 
Specify 3 0 
Sense Interrupt Status 1 2 
Sense Drive Status 2 1 
Recalibrate 2 0 
Seek 3 0 


Read ID 2 7 
Format Track 6 7 
Read Data 9 7 
Read Track 9 y 
Write Data 9 7 


With single-sided floppies the term 
“‘track’’ is defined. With two sided 
disks the usage is less clear. I will use 
the term cylinder to mean the position 
of the heads with respect to the disk and 
the term ‘‘track’’ to mean the location 
that a single head can access when lo- 
cated at a specific cylinder. In general 
we can find the cylinder and head for a 
two sided disk knowing the track by: 


cylinder = track / 2; 
head 


/* integer divide */ 
= track % 2; /* remainder of integer divide *}; 


For single-sided disks the head is al- 
ways 0 and the cylinder is equal to the 
track. 


Getting Started 

The first routines that I wrote were 
three routines to interrogate the status 
ports and wait until they are clear. 
These routines are cmdstat() which sig- 
nals that the 8272 is ready to accept a 
command byte, intstat() which signals 
the completion of the execution phase, 
and resultstat() which signals that the 
8272 is ready to have a result byte read. 
The code for cmdstat() is given in list- 
ing 1. 

Next I wrote routines that would 
interpret the results returned by the 
8272 after command execution. The 
8272 has four status registers named 
Status Register 0 to Status Register 3. 
Each of these registers is one byte wide. 
Almost every bit in each status register 
byte has a meaning. Not every com- 
mand returns results in all registers. In 
addition to the status registers, with 
some commands, the 8272 returns in- 
formation about the current track, cur- 
rent sector, current head and the num- 
ber of bytes per sector as, single byte 
values. The routines stO(),st1(),st2(), 
and st3() display the mnemonic for the 
individual bits along with their values 
for the four status registers. 

The code to display the results re- 
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LISTING 1 


/* reads the 8272 status port untill the chip is ready for a command */ 
/* byte, must be done before each command byte is sent to the 8272 */ 
int cmdstat () 
{ 


char Cc; 


while ( (c = inp(fdcstat)) < 0x80); 


return (TRUE) ; 


LISTING 2 

/* print value of 8272 status register 0's bits */ 

st0 (byte) 

char byte; 

{ 

char drive,hd,nr,ec,se,ic; 
drive = byte & 3; /* drive number */ 
ha = (byte >> 2) & 1; /* head address ie; O or 1 *y/ 
ne = (byte >> 3) & 1; /* not ready 46 1 */ 
ec = (byte >> 4) & 1; /* equipment check */ 
se = (byte >> 5) & 1; /* seek end */ 
ic = (byte >> 6) & 3; /* interrupt code, does not */ 

/* work aS per 6272 data sheet for read and write commands) */ 


/* since Godbout did not implement the terminal count line */ 


printf("\n STO> &%s %u %s %u %s %u $s Su &s Su &S Bu ny 


"drive = ",drive, ; , 
"head = ",ha," nr = ",nr," ec = ",ec," se = ",se," ic = ",ic); 
}/* stO */ 
LISTING 3 
/* prompt for and return drive number x4 
/* drive may be entered as 'a','b','A','B','0' or 'l' / 
cher getdrive () 
{ 
char drive; 
printf£("\nEnter drive designation "); 
do 
{ 
Grive = getchar(); 
if( (drive == 'A') || (drive == 'B') ) 
drive -= 'A'; a _ 
else if( (drive == 'a') || (drive == 'b') ) 
drive -= ‘a'; : : 
else if( (drive == '0') || (drive == 'l') ) 
drive -= '0'; 
else 
{ 
putchar ('\b'); 
putchar(' '); 
putchar ('\b'); 
while(drive != 0 && drive != 1); 
return (drive); 
} /*getdrive*/ 
LISTING 4 
* 
/* RECAL.C Py) 
f® program for testing routines recal() and senseintstat() 


#include bdscio.h 
#include cdisk.h 


main () 

{ 
char drive; 
int temp; 


while(TRUE) { 
drive = getdrive(); 
printf("\n drive = %u 
recal (drive); 
}/*while*/ 
}/*main*/ 


\n",drive); 


senseintstat (bytes) 
char bytes[]; 
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turned in status register 0 is given in 
listing 2. Bit fields are not implemented 
in BDS ‘C’. I therefore used the ‘shift’ 
operator to move the bits into the right- 
most position and then the ‘and’ oper- 
ator to mask out the unwanted bits. If 
bit fields were available a more elegant 
solution would be to create a structure 
that would permit direct access of the 
bits. 

The five 8272 commands, listed 
above, that return seven result bytes all 
have the same result format so I was 
able to write a single routine, called 
printresult(), that displays all of the 
data returned by these 8272 commands. 

To simplify writing programs to 
test the procedures, I wrote four 
routines to allow the drive, cylinder, 
sector and head to be input from the 
console. These routines are getdrive(), 
getcyl(), getsector() and gethead(). The 
code for getdrive() is shown in listing 3. 


Doing Something 

Now I was ready to write routines 
that did something. The first routine 
was recal(). This routine places the 
head(s) of the selected drive at cylinder 
zero. The 8272 command for recali- 
brate requires two command bytes and 
does not return any result bytes. To 
determine if the recalibration was suc- 
cessful it is necessary to use the 8272 
Sense Interrupt Status command. This 
command returns Status Register 0 and 
the current cylinder number. The last 
two bits of Status Register 0 are called 
the interrupt code (IC). The values of 
IC have the following meanings: 


0 = Command completed 
successfully. 

1 = Execution started but not 
successfully completed. 

2 = Invalid command issued, 
execution never started. 

3 = Command aborted because ready 
signal changed. 


I used the value of IC and the value 
of the cylinder location byte to deter- 
mine if the recalibration was success- 
ful. Recal() returns a true (1)°if the 
recalibration was good. If it was not 
then the routine trys two more times. If 
the retrys are also unsuccessful then 
Status Register 0 is decoded for the 
cause of the failure and an error mes- 
sage is displayed. 

The program that I wrote to develop 
the recal() routine is given in listing 4. 
The program has a short main section 
and two subroutines, recal() and 
senseintstat(). Once I had the program 
running properly I removed the debug- 
ging displays and placed the two sub- 
routines in the library. 

The next command to tackle was 
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(SSS SSS 


/* reads and returns the 8272 status register 0 */ 


dseek() . Dseek() positions the head /* and the current cylinder number */ 
over the specified cylinder. I called it { ; ee 
dseek() to differentiate it from the BDS endetat() § Co ee ee 
‘C’ built-in seek(). Dseek() is similar to cers poner a ae Gee ee eA 
: resultstat(); /* wait till ready for result byte */ 
recal() except that the command phase bytes[0] = inp(fdcdata); /* get status register 0 */ 
requires a third byte, the cylinder num- eth betel o erie oe i lange 0 oe a 
resultstat(); walt til ready for resu yte 
ber, to mi sent to - 8272. I used the bytes[1] = inp(fdcdata); /* get cylinder number */ 
same technique, of writing a program printf£("\ncylinder = %u\n",bytes[1]); 


to check the operation of the dseek() }/* senseint stat */ 
routine, this time since I had already 
developed the senseintstat() routine and 


sg : : * int recal (drive) 
had it in the library, I only had to link it char drive; 
to the test program. f* move the head to cylinder zero, return TRUE if successful */ 
ff® print error message if unsuccessful */ 
Doing More a k; /* try counter */ 
Every command to the 8272 starts cher bytes [8]; /* array to hold results */ 


with acommand byte that has a specific ; : 
: i 2 f£ k=0; k 3; K 
structure. Bits0to4 of this byte contain nes " a 


the code that tell the 8272 which com- cmdstat(); /* wait till ready for command byte */ 
is i outp(facdata,c_reca); * send command byte * 
mand is being called. The command at Pe oe on wait till ready for command byte */ 
codes are given as #define statements outp(fdcdata,drive) ; /* end of 8272 recalibrate command phase*/ 
in CDISK.H (listing 5). Bit six, called intstat(); /* wait till execution phase complete*/ 
the mfm bit, tells the 8272 whether a senseintstat (bytes) ; /* check if recal ok af 
/* check for satisfactory completion and at cylinder 0 17 


single or double density operation is if( ((bytes[0] & no err) == 0x00 ) && (bytes[({1] == 0)) return(TRUE) ; 
requested. Bit seven, called the mt bit, j}/* or */ = 


tells the 8272 whether the operation is printf("\nRecal error drive %c ",drive+'A'); 


‘ H if ( (bytes[0] & ds_err) != drive ) printf("incorrect drive select\n"); 
to be ae sie one ee ed if ( (bytes[G] & nr_err) != 0 ) printf£("not ready\n"); 
command uses the mt and mim bits. if ( (bytes[0] & eg_err) != 0 ) printf("eguipment error\n"); 


In addition to the command return(FPALSE); 
codes, CDISK.H also contains the }/* recal */ 
global variables that I created to reduce LISTING 5 
the amount of data that had to be passed 
between procedures. One particular 
variable requires some additional dis- #define TRUE 1 
cussion. The variable bps describes the “d@fine FALSE @ 


format of the disk. The bytes per sector /s» the following sets the conditional compile in setdma() so that the */ 
are related to bps by the formula: bytes /* tpa(transient program area is in page @ for CPM 2.2 and page 1 for */ 


/* CDISK.H xf 


per sector = 128 * 2 bps. /* CPM 3. If you are using with CPM 2.2 or a nor-banked CPM 3 set to */ 
The readid() routine, which returns vs Beg ae TRUE “ 

the density and format of the selected 

disk, was the next to be implemented. /* DISK1 PORTS a7 

The 8272 read ID command requiresa *¢@fine fdport exco /* base address of disk controller = ¥/ 


at define fdestat fdport /* 8272 status port wa 

two byte command phase. Bit six of the #define fdcdata fdport + 1 /* 8272 command and results data port BA 

first byte must be the mfm bit. But we #define fdma fdport + 2 /* Disk1 DMA port (write) */ 
+2 


don’t know if we are doing a single or *de@fine ints fdport /* Diski interrupt status port (read) */ 
double density operation. In fact the 


ye 8272 COMMAND CODES Bid 
reason to use the 8272 read ID COM- define c_rtk  @x02 Su bead a track */ 
mand is to determine the density and #define c_spec 0x@3 /* specify Ks 
the format of the disk. If the mfm bit is *#@fine c_dsts 2x24 /* sense drive status a 
. 1 he 8272 dID adefine c_wrat @x@5 /* write data UE 
set Incorrectly the read 1D COM-  gdefine c_rdat x06 /* read data */ 
mand will return a non zero interrupt #define c_reca x07 /* recalibrate pis 
code (IC), in status register 0, during sophie ig dict! hee Se a ore status ny 
erine c_rdi x * rea 
the result phase. The way I constructed ggerfine cfore Boo a does #7 
the readid() routine was to set the global agefine c_seek @xOF /* seek */ 
variable mfm[drive] to 1 (double 
density), call the 8272 read ID com- as e272 ice poate ida, gk a #/ 
=i : ; #define ds_err x ncorrec sk selec 
mand, then check for IC = O indicating geting ny err @xee /* vot ready: error a 
a correct operation. If the operation is #define eqlerr x12 /* equipment error py 
correct the routine sets the global vari- #define no_err Oxc® /* no error ip 
able n[ drive] equal to result byte six, BLORAL. OARTRBLES */ 
and returns true. If IC is non zero then /+» globals have the form variable(drive] where drive is @..3 wy: 
mfm is set to 0 (single density) and the &) 
8272 readID command is called again. Shar mt C414 ae Stet ee Soe = Sy See eae Se Hi 
If thi : IC i did char mfmC4] 5 /* double density = 1, single density = @ yf 
t 1S time 1s Zero readid sets on, skl41; 7* skip (not used) always 0 */ 
n [ drive ] and returns a true value. IfIC char bps [4]; /* bytes per sector @,1,2,3 for Godbout format */ 
is not zero then the other status registers char ect [4]; /* — — number of track MY 
. +o, char gpll4); /* gap leng 
are decoded, an error message is dis cine dt 104d; 7# Hake Vength */ 
played and the routine returns false. In 
any event the seven byte results array is int Yi /* cursor coordinates used by iolib.c ef 
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LISTING 6 


/* Getresult () 


routine reads the results from a read,write,format or */ 


/* reaaid commend returns TRUE for a good read or write */ 
int getresult (bytes) 
cher bytes[]; 
{ 
int k; /* byte counter */ 
for (kK = Op kK< Te) f ; ; 
resultstat(); /* wait till ready for result byte */ 
bytes([kt++] = inp(facdata); /* read result byte */ 
} ’ -  - 
return((bytes[1] == O0x&0)); /* return TRUE if end of cylinder */ 
}/* getresult */ 
LISTING 7 
af 


/* DENSITY.C 


/* program to return number of siaes, density and format of a 


#include bascio.h 
#include cdisk.h 


main(argc,argv) 


char Rar gyy 

{ 
char cyl,hds,drive; 
cher bytes[8]; 
int i 


printf("\naensity version 1.3\n") 3 


arive = getdrive(); 

hds= 0; 

cyl = 2; 

dseek (drive,cyl); 

getmt (arive); 

reedia(drive,has,bytes); 

printf("\ndrive %c is 
if (mt[drive]) 
else printf("Single sided, "); 


switch (n(drive]) { ; 

case U : printf("Single density 
break; 

case 1 : printf("Double density 
break; 

case 2 : printf("Double aensity 
break; 

case 3. : printf("Double density 

} /*® switch *7 


} /* aensity */ 


disk */ 


/* request drive */ 
/* select head 0 */ 
/* select cylinder 2 of 
/* position head 
/* find number of sides / 


/* find density and format */ 


"(drivet'A')); 
printf£("Double Sided, 


"he 


with 128 Byte sectors\n"); 


with 256 Byte sectors\n"); 
with 512 Byte sectors\n"); 


with 1024 Byte sectors\n"); 


LISTING 8 


J segment of setparam() 


else 
switch (nldrive]) { 
case l : gpl[drive 


eot [drive] 
dtl [drive] 


: gpl[drive 


eot [drive] 
dtl(drive] 


: gpl[drive 


eot [drive] 


atl[{drive 
break; 
} /* case */ 
}/* setparam */ 


returned to the caller. The readid() 
command is the first to be discussed 
that returns seven result bytes. To read 
those bytes from the 8272 I created the 
routine getresult() which is shown in 
listing 6. I'll say more about getresult() 
later. 

Using readid() we have the density 
and the number of bytes per sector,but 
we still need to know if the disk is 
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code */ 


/* double density */ 


= Ox0e; /* gap length */ 
= Oxla; /* last sector on track */ 
= Oxff; /* no meaning in aa */ 
= Oxlb; /* gap length */ 
= Ox0f; /* last sector on track */ 
= Oxff; /* no meaning in da */ 
= 0x35; /* gap length */ 
= 0x08; /* last sector on track */ 
= Oxff; /* no meaning in da *7 


single- or double-sided. The number of 
sides on a disk can be determined by 
looking at the two-sided bit in Status 
Register 3. The 8272 Sense Drive Sta- 
tus command returns Status Register 3. 
Routine getmt() issues the 8272 Sense 
Drive Status command, reads the two 
result bytes, and then sets the global 
mt [drive ] byte in accordance with the 
two sided bit in Status Register 3. 


At Last A Program 

We now have all we need to write 
the program Density. This program re- 
ports the number of sides, the density 
and the number of bytes per sector of a 
disk in the selected drive. The program 
is given in listing 7. 


Going Further 

All of the read and write commands 
as well as the format command require 
that the Disk! be told where in memory 
to read from or to write to. The 
setdma() routine does the job. As it is 
written, all addresses are on 64k page 
0. That can easily be changed if you 
want to address other pages, since the 
Disk! DMA register is a3 byte register. 

The 8272 read and write commands 
require a 9 byte command. I have 
already discussed the content of the 
first byte. The second byte tells the 
8272 which drive and head to use. The 
next four bytes are the cylinder, the 
head, the sector and the number of 
bytes per sector. The remaining three 
bytes describe the disk format. The first 
of the three final bytes is called EOT 
and is the number of the last sector ona 
side (the first sector is 1). The next byte 
is GPL, the gap length, which is the 
spacing between sectors. The final byte 
is the data length, DTL. DTL has sig- 
nificance only when bps is O (ie; 128 
bytes per sector). 

The values of EOT, GPL, and DTL 
are determined by the values of mfm 
(density) and n (bytes per sector). 
Routine setparam() when called after 
readid() will define the values of the 
global variables EOT, GPL and DTL. 
Listing 8 is a segment of the setparam() 
code. 

Before I could implement the read 
or write commands I had to create a 
routine to fill the command byte array 
with the nine command bytes. Four 
very similar commands do the job. The 
routines are called set??cmd() where ?? 
is: 


rs: to read one or more sectors 
re: to read a cylinder 
ws : to write one or more sectors 
wc: to write a cylinder 


Listing 9 contains the code for 
setrscmd(rdcemd,drive,cyl,sector, 
sectors,hds). Rdcmd is an 9 byte array 
to hold the read command. 

Using the rs or ws routine permits 
any number of sectors on a side to be 
read or written. The first sector to be 
read or written is passed to the routine 
as sector and the number of sectors to 
process is passed as sectors. Note that 
when I talk about sectors I mean 
physical sectors which can be 128, 256, 
512 or 1024 bytes long, not CPM 
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LISTING 9 logical sectors that are always 128 


bytes long. 
/* Setrscmd() fills the 9 byte read command array ¥*/ The 8272 chip has the capability of 
setrscmd(racmd,drive,cyl,sector,sectors,hds) doing multitrack reads or writes. That 
char radcma[],drive,cyl,sector,sectors,hds; Is, it can Start on side 0 and complete 
{ _ the operation on side 1. The read cylin- 
racma [0] = (mfm(drive]<<6) | (sk[drive]<< 5) | e_rdat; der (rc) and write cylinder (wc) com- 
racma{1] = (hds << 2) | drive; /* head and drive data */ arenes require thatbit seven of the-titet 
racmd = 1; /* cylinder number * s i 
Epone 3 = Ras! /* head oy command byte be set to mt [drive ] to 
7 : A’ Savee BGGter Eo Dead x7 enable (value = 1) or disable (value = 
racmd[5] = nldrive]; /* disk format */ fi es nS 
rdcmd[6] = sector + sectors - 1; /* last sector to read */ 0) a multitrack operation. ae? 
rdcmé{7] = gpl{drivel; /* gap length */ The routine dread() (listing 10) 
: racmé [8] = dtl [drive] ; sends the command bytes to the 8272, 
if* sehmsana */ waits until the execution phase is com- 
LISTING 10 plete, and then reads in the result bytes 


from the 8272. The dwrite() routine 


* perf a a >rati itt s linder. Must h s * ‘ 
/* perform a reaq operation either sector or cylinder u ave set up / operates in the same way as dread(). 


/* the rdcmé({] erray before calling this function. Returns TRUE if read, 


/* was successful FALSE if an error occured. *) Now putting it all together, the 
sequence for a cylinder read is: 
int dread (rdacmd,bytes) tinkbeeNi nl 
char roecma[]; /* array contaning the read commend */ eet Acre ae ; 
_ j s sc) H * position hea 
‘moe bytes[]; /* array to recieve the results a getmt(drive); 2 eeemniermiont iy 
frit 43 /* byte counter */ readid(drive,hds, bytes); * determine n and mfm 
setparam(drive); * determine EOT,.GPL and DTL 
for (j = 0; j < 9;35++) /* send 9 bytes */ setrccmd(rdemd,drive,cylinder); —_/* fill command array 
; ’ dread(rdemd, bytes); * execute command 
cmdstat(); /* wait till ready for command byte */ . 
outp(fdcdata,rdemd[j]); /* send read command byte */ I put the last six commands together 
to make a single readcyl() routine thé 
intstat(); f* Wait till end of execution phase */ does the ail job ter catinaly Is 
if(getresult(bytes)) return(TRUE); i gage 5 . . 
ee f called. A similar routine was developed 
printf("\nread error drive tc heed %u ", to write a cylinder and named 
( (bytes[0]&3)+'A' ),( (bytes[0]>>2) & 1) ); writecyl(). 


geterror (bytes) ; 
return (FALSE) ; 
} 


}/* Greaa */ 


If only a track is to be read, the 


‘o MAIN/FRAME 


FOR $100 BUS OR SINGLE BOARD COMPUTERS 


© Low Price - Model 2210 (shown) $350° 

e Low Profile - Set display on top, keyboard in front 
@ Laser/3000 - Modern office styling - Model 3310 $387° 
e 5% Winchesters & Floppies - Full or Half 

e 4 Card $100 Motherboard and Connectors 

e Accomodates I/O Personality Boards 

© Hefty Power Supply - $100 and Drive, Controllers 
® Multifan, Push-Pull Cooling System 

@ Multiple EMI Filters 

e Switched AC Outlets 

e INTE/National Power Supply 115/230, 50-60 Hz 


“Call for quantity pricing. 


Write or call for our brochure which includes our application note: 
“Making micros, better than any ol’ box computer.” 


RESEARCH CORPORATION 
8620 Roosevelt Ave./Visalia, CA 93291 209/651-1203 
We accept BankAmericard/Visa and MasterCard 


Disk drives & computer boards not included 


LISTING 11 


/* Geterror() prints an error message for an incorrect read or write*/ 


/* command, detailing the error. Must call getresults(bytes) first. */ 
po eh geterror (bytes) 
cher bytes[]; /* array containg the results bytes */ 
{ 
if (( bytes[0] & &) != 0) printf("not ready \n"); 
if (( bytes[1l] & Ox7f) != 0) 
if ((( bytes[1] & 1) != 0) && (( bytes[2] & 1) == 0) 
printf("missing ID address mark\n"); 
if (( bytes({1] & 2 ) != 6 ) printf("write protected\n"); 
if (( bytes{1]) & 4) != 0) printf("no data transfered \n"); 
if ((( bytes[1] & 0x20) != 0) && ((bytes[{2] & 0x20) == 0)) 
printf("cre error in ID field\n"); 
} 
if (( bytes[2] != 0)) { 
if (( bytes[2] & 1) != 0) printf("missing data address mark\n"); 
it (( bytes[2] & 0x20) != 0) printf("cre error in data field\n"); 
if (( bytes[2] & 0x10) != 0) printf ("wrong cylinder\n"); 
} 
return (TRUE) ; 
}/* geterror */ 
LISTING 12 


/* Segment of setform() command that sets up format commend sequence «/ 


/* to be read by the controller as it formats each sector. */ 

for(sector=l,k = 0; sector<=eot[drive]; sector++){/* do for each sector*/ 
buffer[(k++] = cyl; /* cylinder */ 
buffer[k++] = hds; /* head (side)*/ 
buffer[k++] = sector; /* sector */ 
buffer[k++] = n[drive]; /* format */ 


L/* fox */ 
}/* setformat */ 


the number of sectors to read as 
eot [drive], which will read all the 
sectors on one side. The resulting 


command sequence of readcyl() is 
modified by replacing setrecmd() 
with setrscmd(rdemd, drive, 


cylinder,head,1,eot [drive] ). Here I 
have set the first sector to read as | and 


routine is readtrack(). Its companion is 
writetrack(). 


How About Formatting? 

The only primitives left to do are 
those for the formatting operation. The 
routines required to format a track are 
similar to those for the read or write 
operations. The setformat() routine is 
similar to the setparam() routine. A 
separate routine is required because the 
value for GPL is different for format- 
ting and read/writing . It is also neces- 
sary to supply the cylinder,head, sector 
and bytes per sector (bps) for each sec- 
tor in the track to be formatted. During 
the formatting operation the 8272 reads 
each set of four values prior to format- 
ting the sector. The code of setformat() 
is shown in listing 12. 

The setformcemd() is similar to the 
setrtcmd() except that the command is 
only six bytes long. The last byte in the 
command array is the value of the data 
mark (E5). Routine form() is similar to 
dread() and dwrite(). 

Formtrack() puts together all the 
routines required to format a track. 
Finally the routine formcyl() formats an 
entire cylinder. Multitrack operations 
are not allowed with the 8272 format 
command. A cylinder of a two sided 
disk therefore requires two calls to the 
form() routine, once with hds set to 0 
and once with hds set to 1. 
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800D2F 
5" Floppy Main/Frame 


(40 cards) $392 


| 


32 Page 
Free Fakt 


\ Pakt Catalog 
tex 


2215 
5” Floppy Winchester 
Main/Frame (7. cards) 


$380 


Write or call for our brochure which 
includes our application note: 
“Making micros, better than any 


ol’ box computer’’ 


2905 
5" Disk Enclosure $400 


—INIECRSNID 


8620 Roosevelt aes CA 93294 


209/654-1203 


We accept BankAmericard/ Visa and MasterCard 


On To Higher Levels 

I have now described all of the 
primitive routines. We could at this 
point write the utility programs; 
however, several operations of the 
same form appear in the utilities and it 
is worthwhile creating some higher 
level routines. The higher level 
routines were put in library 2. 

The first of the high level routines is 
verifycyl(). This routine sets the DMA 
address then does a cylinder read. If the 
read is successful, verifycyl() returns 
true, else it returns false. If verifycyl() 
returns true, we know that the cylinder 
is properly formatted and can be read or 
written to. 

If we find an error on a cylinder we 
would like to know which sectors are 
defective. The routine, versectors(), 
does that job by reading each sector, 
one at a time, and reporting any errors 
that are found. Each side of a two sided 
disk is handled separately. 

The high level routine, Verify(), 
combines verifycyl() and verifysecs() 
to examine an entire disk and report all 
defective tracks and sectors. Verify() 
first checks all 77 cylinders and collects 
all defective cylinders in an array 
named badcyls (1. If any errors are 
found, verify() calls verifysecs() for 
each of the bad cylinders. 

Reader() reads multiple cylinders 
into a buffer. It simply calls readcyl() 
the required number of times. 

Compare() compares the contents 
of two buffers. The buffers are assumed 
to be cylinders containing sectors. If 
differences in the buffers are found, the 
cylinder and sector numbers of the dif- 
fering sectors are displayed on the con- 
sole. If no difference in the buffers is 
found, true is returned. 

Dmpsec(start,chunk) prints one 
physical sector to the console in ddt 
format. The dump starts at location 
start and the size of the physical sector 
is chunk. 

Dmpcyl() prints an entire cylinder 
to the console, one sector at a time. It 
first calculates the size of the physical 
sector, then determines the total num- 
ber of sectors to print. Dmpcyl() calls 
dumpsec() to do the printing. 


Now The Utilities 

Writing a program to verify a disk is 
now merely a matter of command line 
processing and calling verify(). 

The program formtrk formats a 
single track. After processing the com- 


mand line arguments, the program § 


prompts for the cylinder number, head 
and the number of bytes per sector. 
Knowing the bytes per sector, the pro- 
gram sets the value of mfm [drive ] . 
The track is then formatted. If an error 
is encountered in the formatting opera- 


tion, the contents of the status register 
are printed, and the program is aborted. 
If the formatting goes well, the track is 
verified with verifysecs(). Among 
other things, formtrk allows you to for- 
mat the second side of track 0 which the 
Godbout format program does not do. 

Deopy is a disk to disk copy pro- 
gram. It reads and writes four tracks at a 
time for double density disks (four 
cylinders for single sided drives, two 
cylinders for double sided drives) and 
eight tracks for single density disks. 
The program gives the user the option 
of verifying the copy operation. With- 
out the verification the program copies 
a disk in less than half the time required 
by the Godbout supplied routine. I have 


yet to find a compare error when mak- 
ing a copy. 

Dumpcyl reads a cylinder from a 
disk and displays each physical sector 
on the console in ddt format. Readsec 
reads an individual sector from the 
selected disk and displays it on the con- 
sole. 


How To Fix A Disk 

The repair utility is useful when you 
have formatting errors on one or more 
sectors of a cylinder. The program first 
determines if the errors are on the headQ 
side or the head1 side or both. Next the 
program reads the bad track(s) into a 
memory buffer, sector by sector. Bad 
sectors are filled with data marks (e5 


INCREASE YOUR MEMORY 
WITHOUT LOSING 
YOUR SHIRT! 


HIGH SPEED STATIC RAM BOARDS 
$449 ...128K Bytes / 256K Bytes... $749 
Quantity One Prices That Make Sense 


FEATURES: 


@ Operates in excess of 138 MHz 

® Certified system ready (dynamic burn in) 
@ Supports 8 and 16 bit data transfers 

@ |EEE 696/S-100 compatible 


@ 24 bit addressing 


@ Address strappable to any 128K block within the 


16 meg address range 


@ Extremely low power consumption 
@ Optional battery back-up capability 


@ Single +5 volt operation 


@ One year warranty 


Call today for more information... 


(603) 881-8334 


ERFORMICS 


ee a 
11 Morning Dove Rd. @ Kingston, NH 03848 


hex). From this point on we are vulner- 
able to program failure since once we 
reformat the track the only place that 
has data is the memory buffer and ter- 
mination of the program will result in 
loss of the entire track. To insure the 
greatest chances of success I do a loop 
controlled by verifysec(). If verifysec() 
returns a false, another attempt (up to 3) 
to format the track is made. After the 
track(s) are reformatted three attempts 
to write the buffer back to the track with 
writetrack() are made. If these attempts 
fail, probably as the result of permanent 
disk damage, a sector by sector write is 
done to recover as much data as 
possible. 


How To Recover A Directory 

Having a disk sector failure is al- 
ways a traumatic experience. If the sec- 
tor happens to be on the directory track, 
the problem is particularly severe, 
since the disk can’t even be accessed. 
One way to recover some of the files is 
to use the repair utility. In this case only 
the files whose directory entries are on 
the bad sector(s) are lost. With 128 byte 
sectors, only four files would be lost. 
With 1024 byte sectors, however, 32 
files would be lost. Two sided drives 
offer a valuable technique to protect 
against these occasional problems. 

The technique makes use of the fact 
that side 1 of cylinder | (track 3) is not 
normally used. We can use this track to 
store an image of the directory track. 
The utility savedir does that job. Fre- 
quent use of savedir will insure that the 
directory backup is current. When that 
terrible moment comes and we have a 
directory failure the program fixdir 
comes to the rescue. Fixdir works much 
like repair except that instead of filling 
bad sectors with data marks the bad 
sectors are replaced with their backups 
from track three. When the repair is 
completed a list of the files in the 
affected sector(s) is displayed on the 
console. 


Non CP/M Applications 

lalso run the UCSD ‘P’ system. My 
bios requires that I use two systems 
tracks. For simplicity I format both 
tracks as single density 128 byte sec- 
tors. The program pform does the job. 
For a single sided disk cylinders one 
and two are single density for a two 
sided disk both sides of track 0 are 
single density. After formatting is com- 
plete the disk is verified. 

The program getcode was created 
to allow reading sections of the systems 
tracks and placing the code in normal 
CP/M files. This program was very 
useful in copying the ‘P’ system 
SBOOT from its location on track 0 so 
that I could later relocate it to allow for 


a larger primary boot. It can of course, 
also be used for moving parts of other 
operating systems. 

Putcode is the reverse of getcode. 
Putcode reads a standard CPM file and 
then writes it to selected tracks and sec- 
tor. | used this program to place the ‘P’ 
System primary boot, SBOOT, and 
sbios where I needed them. 

Pgen is a program for the ‘P’ system 
that does the same job that sysgen does 
for CP/M. The program reads the first 
two tracks (the systems tracks) of the 
source disk and writes then to the first 
two tracks of the destination disk. It 
checks to see that the disks have the 
same format since the primary boots are 
different for single and double sided 
disks. 


10 Interface 

I placed all the console hardware 
specific routines in a file called iolib.c 
allowing easy modification for diffe- 
rent consoles. 


On Your Own 

The complete listings are available, 
on disk, from the SIG/M public domain 
library. Using the libraries you can 
readily create your own utility pro- 
grams and/or improve mine. If you do 
either I’d be interested in hearing from 
you. 


Disk Sale 


Dysan 


TYPE BOX OF 10 
5"-SS/DD-48 TPI 19.50 
5"-DS/DD-48 TPI 25.50 
5"-SS/DD-96 TPI 29.50 
5"-DS/DD-96 TPI 37.50 
5"-DS/DD-IBM/AT 52.95 

23.95 

25.50 

29.95 

Available Soft or Hard Sector 

For Plastic Case Add 1.25/Box 


Plus Tax & Shipping 
- Cash, Visa, Mastercard, COD - 


Integral Systems Corp. 
2900-H Longmire Drive 
College Station, TX 77840 
(409) 764-8017 


8"-SS/SD-48 TPI 
8"-SS/DD-48 TPI 
8"-DS/DD-48 TPI 


Of course, 
POWER! saves 
your Bad Disk. 


NOW! WINDOWS FOR IBM! 


It also does 


keep your disk in line. 


EVERYTHING YOU ALWAYS WANTED 

TO DO, BUT WERE AFRAID TO TRY 
Unlike some utility programs that are a headache 
touse, POWER! is engineered to spoil you with 55 
features, simple and uniform commands, and utter 
simplicity of use. POWER! automatically alpha- 
betizes and numbers your files. You select by the 
number and never type file names again. Need to 
[copy], [RENAME], [ERASE], or [RUN] programs? Just 
type in their menu number! POWER! also locks 
out your disk’s bad sectors [TEST] without destroy- 
ing files—a critical difference from other utilities 
that search and destroy, without informing you 
what they’ve done, leaving you to wonder why 
your programs won't run. (And POWER! still has 
50 commands to go!) 


POWER! ONE PROGRAM DOES IT ALL! 


You may own a few utility programs for your com- 
puter housekeeping, each with its own commands 
tomemorize. POWER! has all the programs rolled 
into one 16K integrated package, so you do things 
you've never tried before—every day. Save sen- 
sitive data from prying eyes with [PASS] word pro- 
tect, move a block of memory [MOVE], look for data 
[SEARCH] or compare files [CHECK]. POWER! also 
makes easy work of patching, [DISPLAY/SUBSTITUTE], 
customizing software [LOAD/SAVE]. Among the 
other commands are [SIZE], [Stat] [LoG], [DUMP], 
[Type], (JUMP), [FILL], [SET], and the CP/M version 
lets you restore erased files—even when you don’t 
remember the filename—at a flick of the POWER! 
[RECLAIM] command. (Still 31 commands to go!) 


POWER! NOW FOR IBM’s PC-DOS 
AS WELL AS CP/M 


We first developed POWER! for CP/M two years 
ago, and a stack of testimonials from FORD to 
XEROX testify to its excellence. For IBM-PC™ 
users, special features like managing sub-direc- 
tories, [CHANGE], and a separate creation of up to 
8 simultaneous, on-screen [WINDOWS] have been 
added. 


MONEY-BACK GUARANTEE AND 
A 10 DAY TRIAL 

POWER! has the Seal of Approval from the Pro- 
fessional Software Programmers Association, and 
you, too, must be happy with POWER!-—or your 
money back! For only $169 you can now really be in 
control of your computer. Call Computing! at (415) 
567-1634, or your local dealer. For IBM-PC or any 
CP/M machine. Please specify disk format. 


The company that earns its exclamation point. 


COMPUTING! 


2519 Greenwich, San Francisco, CA 94123 


TO ORDER CALL 800 TOLLFREE 


800-428-7825 Extension 96C 
In CA: 800-428-7824 Extension 96C 


IBM and IBM-PC are registered trademarks of 
International Business Machines Corporation. 


CP/M EPROM 
PROGRAMMING SYSTEM 


2708 2016 
2008 2132A 
2716 20128 
2132 27206 
2764 2ICXX 


—SOFTWARE SPECIFICALLY DESIGNED FOR CP/M COMPUTER Nl dls 

— STAND ALONE BOARD _ — ELECTRONIC SWITCHING OF EPROM TYPES. 

— USES 24 VOLT XFMR FOR POWER — — ALL SUPPLIES/TIMING ON BOARD 

— DESIGNED WITH EASY TO GET PARTS — LARGE COMPREHENSIVE MANUAL 


* * CENTRONICS INTERFACE * * 


CONNECTS TO ANY CENTRONICS PRINTER INTERFACE — USES 8 OUTPUT 
DATA BITS AND ONE INPUT DATA BIT (BUSY LING). BUSY LINE IS A 

HIGH SPEED SERIAL INPUT. FULL EPROM READING AND PROGRAMMING 
INSTALL. PROGRAM PROVIDED FOR QUICK INSTALLATION TO HOST SYSTEM 


* * CONTROL PROGRAM COMMANDS * * 


— PROGRAM EPROM(S) PROM DISK — SAVE ee TO DISK 

— READ DISK FILE INTO RAM — PROGRAM EPROM(S) FROM RAM 
— READ EPROM(S) INTO RAM — COMPARE EPROM WITH RAM 

— VERIFY EPROM IS ERASED — COPY EPROM 


— DISPLAY/MODIFY RAM — (MONITOR MODE) WITH 11 SUB COMMANDS 
FILL—DUMP—XFER-EXAMINE-MODIFY -BIAS-PROGRAM- VERIFY, ETC) 


BARE PC. BOARD WITH COMPLETE DOCUMENTATION 
AND SOFTWARE ON 8" SINGLE DENSITY DISKETTE $69 


ABOVE WITH COMPLETE PARTS KIT — Sestaar — $189 
OFTWARE AVAILABLE FOR OSBORNE, KAYPRO AND OTHER 5 1/4 FMTS 


TO ORDER SEND CHECK, MONEY ORDER, WRITE OR CALL 
ANDRATECH 
P.O. BOX 222 
MILFORD, OHIO 45150 
(513) 752-7218 


CALL_OR WRITE FOR MORE INFORMATION —— ADD $300 FOR SHIPPING 
OHIO RES. ADD 55% TAX -- VISA/MC. ACCEPTED -- $300 FOR COD 


“Z80ASM is an extraordinary product...”, 
Robert Blum, Sept. 84 DDJ 


ASSEMBLERS 


e RMAC/M80 macros ©@ Math on external 

© Nested INCLUDES & words and bytes 
conditionals e Define symbols from 

@ 16 char. labels on console 
externals © Generate COM, HEX, 

e Built in cross- SLR-REL, or Micro- 
reference soft-REL files 

© Optional case e Time & Date in listing 
significance © Over 30 configure 
Phase/dephase options 


Z80ASM -full Zilog Z80 ................. $125 

NEW! Z80ASM+ -all tables virtual .............. $195 
NEW! SLRMAC -full Intel 8080, with 

Z80.LIB extensions internal ........... $125 

NEW! SLRMAC+¢ -all tables virtual ............. $195 


Z80 CPU, CP/M compatible, 32K TPA required. 


“Z80ASM...a breath of fresh air...”, 
Computer Language, Feb. 85 


= C.0.D., Check or Money Order Accepted 


TIMES FASTER! 


SuperFast Software Development Tools 
INCREASE YOUR PROGRAMMING EFFICIENCY 


with high-performance software development products from SLR Systems. 
No other tools approach the speed or flexibility of the SLR Systems line. 


Still Searching 
For Files 
Without _ 

EUREKA! 


27? 


You may not know it, but a disk cataloger can be a big 
help in managing your computer files. Why not go with 
the best? EUREKA! is a terrific time saver for ... 


e Lawyers e Accountants 
e Software Developers e Researchers 
e Writers e Secretaries 
e Teachers e Consultants 
° e Journalists 


Project Managers 


People who try EUREKA! love it..... 


‘Just started cataloging with comments - Great Idea’ GR-MI 
“Great time saver in locating material on disks.” WB-NY 
“Your manual is the best written | have ever seen.” MT-NS 


“We finally chose EUREKA! ... largely because it has the ability 
to read comments directly from a file EUREKA! is easy to 
learn and use, has more access and report choices, finds files 
by many different ways, and has an attractive price.” 

T. Bove & C. Rhodes, USER'S GUIDE No. 11 


EUREKA!, the popular CP/M® disk cataloger 


Still only $50 
Mendocino Software Company, Inc. 
Dept.M -3 
P.O. Box 1564 
Willits, CA 95490 
add $2.50 shipping (707) 459-9130 VISA & MasterCard 
Calif. residents add 6% sales tax accepted 


A EUREKA! package is designed to run on only a single system 
Licenses for additional systems (for a single user) are $15 each 
EUREKA! is a trademark of Mendocino Software Company, Inc 
CP/M is a registered trademark of Digital Research, Inc. 


“in two words, I'd say speed & flexibility”, 
Edward Joyce, Nov. 84 Microcomputing 


LINKERS 
e Links SLR & M80 e Three separate 
format files address spaces 
© Output HEX or COM e Load map and 
file SID/ZSID .SYM file 


SLRNK+ includes: 
e All tables overflow to e Works with 


disk FORTRAN & BASIC 

e HEX files do not fill e Generate PRL & SPR 
unused space files 

e Intermodule cross- e Supports manual 
reference overlays 

© EIGHT separate e Full 64K output 


address spaces 


SLRNK -fastest memory based ......... $125 
NEW! SLRNK¢+ -full featured virtual ........... $195 
Combo Paks available from $199. - $299. 
For additional information contact SLR Systems 
1-800-833-3061, in PA (412) 282-0864 
1622 N. Main St., Butler, PA 16001 - Telex 559215 


L R__Systems 


ICX TOOLKIT T 


CP/M I S 
MS-DOS = I S 

New Release for PDS & MDS 
ICXv.4 eXchanger now supports BOTH 8” MDS and 5- 
1/4" iPDS formats. Manipulation of ISIS-II files using 
your computer system was never easier. 
ISEv.6 Emulator gives the CP/M 80 user access to all 
the ISIS-II languages and utilities. 
Complete source (C and MAC asm) included 


ICXMD S vias 2 ejaciencoina oo cimesesinnn ces agement s $89 
IGXPDS sas. sscssesiscaais wis'e'e sinrs seers wrecarsie s Sein siaracsvedisoieiors s Sue0scs $89 
TS Bivvaisisiscamacnacicratiioess aes caernRuees Fe <sinsirea meres ine es $89 
ICX Toolkit (all 3)........... 06sec ee eee eee eee eens $250 


: ZS DEVELOPMENT PACKAGES Ml: 
ZAS is a full-featured relocatable macro assembler 
which includes multi-pass object linker, downloader, 
and run-time monitor. Supports Z-8 and Z-8000 for 
CP/M and MS-DOS. Request catalog of products. 


Copyrights:CP/M Digital Research, Inc 
ISIS-Il and iPDS Intel Corp. - MSDOS Microsoft 


Western Lares 303-327-4898 


BoxC #* Norwood, CO 81423 


Now With Windowing! 
$49.95 Basic Compiler 


MTBASIC 


Features: 
Multitasking Windowing 
Handles interrupts Interactive 
Fast native code Compiles quickly 
Floating point No runtime fee 


MTBASIC is a true native code compiler. It runs Byte’s Sept. ’81 
sieve in 26 seconds; interpreters take over 1400 seconds! Because 
MTBASIC is multitasking, it can run up to 10 Basic routines at the 
same time, while displaying ten separate windows. Pop-up/down 
menus are a snap to implement. 


The MTBASIC package includes all the necessary software to 
run in interpreter or compiler mode, an installation program (so 
any system can use windowing), three demonstration programs 
and a comprehensive manual. 


AVAILABLE for CP/M (Z-80), MS-DOS, and PC-DOS systems. 


ORDERING: Specify format when ordering. We accept Visa, MC, 
checks and COD. Send $49.95 plus $3.50 shipping and handling 
($10 overseas) to: 


-SOFIAID, In 


P.O. Box 2412 Columbia,MD 21045-1412 
301/792-8096 
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‘<S You Need 
To C You Thru. 


Now the Wijard Ware’ Applications Programmers Toolkit provides 
everything you need to increase your C programming productivity. 


APT" features include: 
©@ COMPLETE SOURCE CODE (over 5000 lines!) 
@ File handling with direct & keyed access 
© Screen and Report Generators, with full screen handling for your programs 
© Generic Terminal Driver for portable code 
© String math functions, and string manipulation routines 
© Reference Manual on Disk (over 50 pages) 
© Tutorial Manual (over 25 pages) with Source for Mailing List Manager 
© A host of useful Utilities, Database and File Editors 
© Available for Lattice C, Mark Williams C, DeSmet C, BDS C, others. 


Also Available: C-STARTER Toolkit, great for learning C!! Includes: Customized 
APT, DeSmet C Compiler, and ‘Programming in C on the IBM-PC” (200 pages) 


APT/MS-DOS versions is... s <056:i6- 6. i506 gesiad 6 oie.3s sare vais & HER $495 
APT/DeSmet C version .....................00 0000s eee $395 
ABT/BDS Ci werslon esis. « sess. 3 tears je scatecn Aquat s Ha)h CALaE eal.» $395 
C-Starter (binary APT, DeSmet Compiler and Book) ......... $295 
APT/Manual only... «.-:-:0i5 :s:sis. 3 scsis 5 sseveia: 5 a's x austin ate s/o shelaie $ 50 


**Detailed Brochures on request** 


*Manual Cost will be applied if APT purchased within 
30 days (810 re-stocking charge.) U.S. funds only, please. 
Trademarna: Mi Doe ren Late Cain. Inc MUM Mark Willams Dasa! CC Ware, CCAMConputer nnoraions, Ic HDS CD Satware 
i CrDigital Reeearch. WiaardWars, APT. C Starter Bhew- Amorioan Teoh 


Call (502) 583- 5527 
Ask for APT” or C-Starter, or Send Check to: 
Shaw *: American Technologies 
830 South Second St. - Box 648 Fn) 
Louisville, KY 40201, USA 
etsindte’ Banlcot tontevite cider RULUTSRAR Ce Iie cepa eh ernie 
ed i NO cet dt * 


$100 
BARE BOARDS 
ANY COMBINATION OF 
3 BARE BOARDS 


$150 


256K Dynamic Memory 

64K to 256K to 1 Megabyte 
Capacity eave 
FDC-1 Floppy Disk Controller 

8” & 5%" Drives 

Z80 CPU 

4 MHZ/2 MHZ Selectable .. 

1.0. Board - 4 Serial Port 

Uses 8251 US ART. N/A 
$100 Clock/Calendar with 

On Board Battery Backup ............. $99 $1 35 
Source Code Monitor On Standard 8” Disk 

USEC WIIG EM 212 iam ice syswerana se ctnaten sere eemactontcas asinimnaberis strand $25 


Monitor In PROM - 2716 


BUY ANY COMBINATION OF 4 BOARDS & RECEIVE 
FREE MONITOR PROM 


256K/510 
64K/360 


$245 
$245 


N/A 


N/A 


N/A 


All Manuals Included - All Parts Available - CA Residents Add Sales Tax 
$4 Min. Shipping - Add $1.65 COD 
We Accept Credit Cards 


COMPUTIME 
8614 HAMILTON AVE., HUNTINGTON BEACH, CA 92646 
(714) 536-5000 
Business Hours 10-5 Monday through Thursday 
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16 Bit Lisp and Prolog 
Implementations 


The conclusion of Bill Wong’s 
in-depth review of muLisp-82, IQ 
Lisp, TLC-Lisp, and micro-Prolong. 


Garbage Collection and Workspace 

Garbage collection is always a 
concern with Lisp-like systems since 
lists are a major resource. 
Performance is more important on 
the 16-bit implementations because 
the number of list cells is larger. 
Collecting more cells takes more 
time, thereby reducing the time 
available for computation. Garbage 
collection time on an 8-bit system is 
usually one second or less, but the 
16-bit implementations can have up 
to ten times the number of list cells. 
Consequently, the garbage collection 
time may amount to several seconds, 
which can definitely interrupt 
real-time or interactive processing. 
Forcing the system to perform a 
garbage collection at key times can 
make a difference in a programs 
response time. For example, the 
performance tests run for this article 
were performed after forcing a 
garbage collection, to ensure that 
none would occur during the test; 
this precaution avoided the addition 
of garbage collect time to the true 
test time. A quick examination of the 
system structure for each 
implementation will show how the 
workspace and garbage collect 
problem was addressed. 

muLisp-82. The 16-bit 
muLisp-82 implementation is similar 
to the 8-bit version. It uses the same 
‘‘closed pointer space’’ architecture 
which does not require type checking 
when accessing list cells. The 
workspace diagram is shown in 
figure 1. The workspace is divided 
into a number of sections containing 
the same type of data items. The 
type of data item is determined by its 
address as compared to the boundary 
address kept by the interpreter. 

The biggest difference is that the 
list space has been increased four 
fold to 256 kbytes. This provides a 
theoretical 64K 4-byte list cells. Each 
cell contains two 16-bit pointers that 
index the data space on a cell 
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boundary. Garbage collection time is 
four times slower than in the 8-bit 
version, and can be as much as eight 
seconds. In general the two pass, 
compacting garbage collector of 
muLisp-82 is faster than those of 
other implementations, and also leads 
to a faster list allocation scheme. 

1Q Lisp. IQ Lisp also uses a 
two pass, compacting garbage 
collector and keeps similar data 
objects in the same partition as with 
muLisp. Figure 2 shows the IQ Lisp 
workspace layout. However, IQ Lisp 
uses a tagged architecture for its 
objects along with a 6-byte list cell. 
The advantage is seen in the number 
of different data types supported by 
IQ Lisp. Also, the address range of 


Variable Stack 


muLisp Interpreter 


Operating System 


the pointers in a list cell is increased 
to the entire 8088/8086 address 
space, if you have enough memory. 
In theory, IQ Lisp could support 
170K list cells in a full megabyte of 
memory. In practice, IQ Lisp will 
use all the memory made available to 
it. Garbage collection can take more 
than ten seconds depending upon the 
amount of memory available and the 
amount of list space in use. 
TLC-Lisp. The TLC-Lisp 
workspace diagram in figure 3 shows 
a different implementation approach. 
TLC-Lisp uses a combination of the 
muLisp-82 and IQ Lisp architectures. 
It is called a BIg Bag Of Pages 
(BIBOP) architecture. As in muLisp, 
the type of each object is found via 


Data type 


Name and number celis 


Character & number strings 


Nodes and D-code 


Program control 


Free space for stacks 


Atom & Pointer references 


Machine code 


Machine code 


muLisp-82 Workspace 
Figure 1 
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objects 256K 
max. 
Assembly language 
funct ions 
31 bit integers 
Atoms & list cells 
all 
IQ Lisp Interpreter | Machine code remaining 
space 
Operating System Machine code Z 


1Q Lisp Workspace 
Figure 2 


its address. As in IQ Lisp, each 
object is tagged - but where is the 
tag? In fact, it is the memory page 
that contains an object which is 
tagged; this is why the Bag Of Pages 
is important. Each TLC-Lisp list cell 
consists of two 16-bit pointers that 
point into the 256K data space, as 
in muLisp-82. Each page (256 
bytes/page) in this data space 
contains the same type of object, 
such as an integer or list cell, and 
has a corresponding entry in a 
data-type table that indicates the type 
of objects in the page. The Bag 
(data-type table) needs to be Big to 
give you enough objects of each 
type. 

Even though it uses 16-bit 
pointers and a 256K list space, 
TLC-Lisp has an edge over 
muLisp-82 since objects such as 
strings, P-code, and vectors are 
stored outside of the list space. It 
also means that TLC-Lisp could 
make use of a megabyte of RAM just 
as IQ Lisp could, and, as in IQ Lisp, 
the garbage collection time can be 
significant with a lot of memory. 
Four to ten seconds is not unusual 
for one-half a megabyte. 
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Stack Space 


P-code, vectors 


TLC-Lisp Interpreter 


Operating System 


Page Type Table 


and Strings 


Machine code 


Machine code 


TLC-Lisp Workspace 


micro-Prolog. Figure 4 shows 
the micro-Prolog workspace 
structure. The small 64K data space 
and the 6-byte tagged list cell means 
a small number of list cells. The 
tradeoff is that garbage collection is 
very fast, since there is less to 
collect. Actually, the 8- and 16-bit 
implementations are very close. The 
only difference is that the 16-bit 
system has separate program (32K) 
and data (64K) spaces. This turns out 
to be almost a four-fold increase over 
the 8-bit version, because the 
operating system is also in a separate 
segment. 

In any given system, garbage 
collection time will vary from 
collection to collection because the 
time is a function both of the 
allocation/deallocation procedures 
and of the current garbage state of 
the machine. Although a larger 
complement of memory takes longer 


Figure 3 


to collect, garbage collection is done 
less often. Memory utilization will 
probably not be a concern for 
machine with 256 kbytes or less 
given the workspace architectures. 
Only IQ Lisp and TLC-Lisp take 
advantage of much more memory. 


Assembly Language Interface 

muLisp-82 does not provide any 
type of assembly language interface. 
Instead it compiles all function 
definitions into a distilled code called 
D-code. This form executes faster 
and is more compact than the normal 
Lisp function format. 

IQ Lisp provides an assembly 
language interface that is well 
defined and very flexible. The 
documentation is quite clear, and a 
complete example is provided in the 
manual and on the distribution 
diskette. Assembly language 
programs must be created using the 
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Microsoft Macro Assembler. The 
loading of assembly language 
functions is done after Lisp is 
running. 

TLC-Lisp does not include a 
machine assembly language interface; 
instead, a P-code virtual machine is 
included, along with a Lisp-based 
P-code assembler. A compiler is 
available separately. Converting 
functions to P-code can reduce the 
size of a function by as much as 50% 
and increases execution speed by as 
much as 300%. 

Although the 8-bit version of 
micro-Prolog had an assembly 
language interface, the 16-bit version 
does not. 


Performance 

Performance benchmarks are 
always difficult to set up and more 
difficult to interpret. They tend to be 
biased even though this may be 
unintentional. Lisp and Prolog are 
particularly susceptible to this 
problem because the method of 
system implementation can make a 
large difference in the results. Minor 
changes in the test data or 
environment can change test times 
dramatically. Please examine the 
following results with this in mind. 

The basic test used in table | is 
the empty loop. This was used as the 
basis for all the other tests. It was 
executed 5000 times, as were the 
other tests, to get times long enough 
to time accurately. The number of 
iterations was reduced when the 
elapsed time exceeded a certain point 
since garbage collect times came into 
play. The result recorded is the 
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micro-Prolog Workspace 
Figure 4 


micro-Prolog Interpreter} Machine code 


Machine code 


computed time for 5000 iterations. 
This may or may not be fair — but 
remember what I said before about 
benchmarks. A garbage collection 
was initiated before timing each test. 
The tests are arbitrary and do not 
completely test the implementations, 
so do not select a system on these 
test results alone. 

Not all implementations had 
built-in functions for the tests 
performed. For example, all the Lisp 
implementations had a loop function, 
but one had to be written for 
micro-Prolog. Also, DR LOGO (a 
Lisp-like language) was included in 
the test set because of its turtle 
graphic support, which was 
compared to the TLC-Lisp turtle 
graphics. 

As it turns out, the empty loop 
test gives a good rating for the 
implementations in general. 
muLisp-82 is the fastest, followed by 
IQ Lisp and TLC-Lisp, which were 
fairly evenly matched. micro-Prolog 
and DR LOGO are the slowest of 
those tested. The CONS test was 
used to see how fast list cells can be 
allocated. Garbage collection was not 
invoked during the test, so these 
times are not included. 

Some of the stranger results 
come in the software floating point 
and list indexing tests. IQ Lisp looks 
much slower, but this is due to the 
way the functions are implemented. 
Instead of using machine code 
functions, IQ Lisp uses a 
combination of Lisp functions and 
machine code to implement software 
floating point support. Likewise, the 
IQ Lisp list index function was 


written in Lisp, since a built-in 
function was not available. Actually, 
IQ Lisp is very fast for most 
operations. 

The turtle graphics turns out to 
be limited by the hardware — the 
times for TLC-Lisp and DR LOGO 
are quite close. This seems 
reasonable since the basic graphic 
functions are built-in machine 
language code. The only difference 
was seen on the screen. Repeatedly 
drawing a square caused DR LOGO 
to move the starting position of the 
square one pixel to the right and up 
about every 75 iterations while 
TLC-Lisp remained at the same 
position after 5000 iterations. 

The slower times of 
micro-Prolog should also be treated 
with reservation, since none of the 
tests really exploit its features. Any 
pattern matching test reveals 
micro-Prolog as the winner even over 
muLisp-82. 

Also, I/O tests, except graphics, 
were not performed since they tended 
to be limited by the hardware rather 
than to the software. Output to the 
screen and the printer was about the 
same for all systems. Disk access 
tests were limited by the differences 
in the I/O functions available under 
each system. 

The test results do show that all 
the systems fair well when compared 
to existing interpreters such as 
BASIC or PASCAL. The screen 
editors also support the premise that 
the Lisp and Prolog implementations 
are fast and powerful enough to run 
general applications as well as AI 
applications. 


Summary 

The new 16-bit Lisp and Prolog 
implementations are more powerful 
and more flexible than their 8-bit 
counterparts. Each of the 
implementations reviewed provides 
different features and advantages. 

muLisp-82 offers speed and a 
screen-oriented text editor. It runs 
under MS-DOS, CP/M-86 and 
variants of both. Screen manipulation 
is customizable, assuming terminal 
attributes are controlled by escape 
sequences. There is also an 8-bit 
CP/M implementation which is 
downward compatible. The infinite 
precision integers provide a powerful 
tool for algebraic manipulation 
programs, which was the original 
purpose for the product. On the other 
hand, muLisp-82 lacks a number of 
the more useful features found in the 
other implementations, such as 
floating point support, vectors, 
MACROs, and error handling. Also, 
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micro- DR number of machines into the Prolog 
Test Description TLC Lisp IQ Lisp muLisp Prolog Logo world. Although the benchmarks do 
90 not show micro-Prolog as a speed 
Empty loop 30 29 10 70 demon, it is very good when it 
CONS test 40 40 11 150 550 comes to pattern matching and 
agi database search. Its only major 
Integer addition 40 37 12 105 550 deficiency is its limited memory 
Float addition 45 400 -- 100 575 utilization, tas prevents 
rare development of large applications. 
Integer multiplication 39 280 14 150 380 The lack of file update support may 
Float multiplication 43 380 -- 150 575 also be a serious problem in some 
; applications. 
Assignment 37 350 11 -- 350 In terms of Lisp, IQ Lisp and 
Indexing: TLC-Lisp take the cake under 
‘ sf PC-DOS and CP/M-86 respectively. 
List 107 2400* 950 7500" 754 The choice as to which system is 
Vector 42 300 -- -- -- better will be more difficult should 
; either appear on the other operating 
String 38 280 24 a 750 system. muLisp-82 is a good 
Graphics: ** alternative to either, if you have to 
: sie 12 ‘move between operating systems. 
Circle: 5 ~ ~ “— micro-Prolog wins hands down for 
Square 1: 9 BE -- -- 31 Prolog implementations because it is 
% Pre 39 the only implementation! 
Square 2: il ~ = aa Lisp and Prolog have been used 
PolySpiral 1: 10 +e -- -- 20 on mainframe computers for serious 
. Al work. The appearance of these 
PolySpiral 2: 30 ar -- -- Stack languages on the 8-bit 
Overflow 


Notes: The test results are in seconds. 


Each test was done using a 5000 iterations. 
Each index test accessed the 100th element of a 120 element object. 
* Computed time based on 500 iterations. 


** Done with only one iteration. 


*** Line and point functions only supported. No turtle graphics. 
-- Test not done since the operation was not supported. 


Benchmark Results 
Table 1 


do not buy half a megabyte of RAM 
if you are going to use muLisp-82 
only because you will not need it. 

IQ Lisp is the best 
implementation for PC-DOS, which 
is its only operating system. There is 
no 8-bit counterpart. It is full of 
features, reasonably fast, and can 
utilize all the RAM you can put into 
your PC. Its error handling is superb 
and the function key and window 
support extremely useful. Although 
its software floating point support is 
very slow, IQ Lisp does support the 
8087. The graphics support is merely 
adequate. The worst deficiency of the 
package is the lack of a resident 
screen editor. 

TLC-Lisp is to CP/M-86 as IQ 
Lisp is to PC-DOS. Actually, 
TLC-Lisp offers a number of 
different choices, since it will also 
run under Concurrent CP/M-86 (a 
multitasking system that supports 
multiple windows). TLC-Lisp also 
offers an alternative to muLisp-82 
under CP/M-86 for all the non-IBM 
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PC compatible machines. These 
machines may actually offer a better 
development environment with faster 
(8Mhz) 8086/80186 based 
processors. 

Although TLC-Lisp does not 
have infinite precision integers it 
does support a wider variety of data 
types and objects than any other 
implementation. Its screen editor is 
far superior to that of muLisp-82 and 
its graphics support on the IBM PC 
is more flexible than that of IQ Lisp. 
In fact, the TLC-Lisp turtle graphics 
rivals or exceeds that of most Logo 
implementations. Support of 
MACRO’s, error handling, and 8087 
support make TLC-Lisp an excellent 
choice, and its ability to utilize large 
amounts of memory is a definite 
plus. For those using Concurrent 
CP/M-86, you can restrict this 
feature. 

micro-Prolog is in a class by 
itself. It does have an 8-bit version 
and runs under PC-DOS and 
MS-DOS, thus opening a gate for a 


microcomputers served as a basis for 
introducing a huge new group of 
people to AI methods and tools, 
because of the low cost of the 
systems and software. The new 
16-bit implementations reviewed here 
fill the gap between the very high 
end mainframes and the low end 
micros. Significant applications can 
now be developed using sophisticated 
Lisp and Prolog tools on relatively 
inexpensive microcomputers. 


LISP SOFTWARE SUPPLIERS 


(muLISP-83) 

The Soft Warehouse 

P.O. Box 11174 

Honolulu, HI 96828 

(808) 734-5801 Price: $250 
(please call after noon P.S.T.) 


IQ Lisp 

Integral Quality 

P.O. Box 31970 

Seattle, WA 98103-0070 

(206) 527-2918 Price: $175 


TLC-Lisp 

The Lisp Company 
330 C Village Lane 
Los Gatos, CA 95030 
(408) 354-3668 Price: Call 
micro-Prolog 

Prolog Systems 

31 Crescent Drive 

Milford, CT 06460 


(203) 877-7988 Price: $275 
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TLC Lisp Benchmark Programs 


Empty Loop Test: (DE LOOP-TEST (FN LIMIT) Graphic PolySpiral 1: 
(DO ((1 i (+ 1 1))) (DE POLY-SPIRAL (D A C) 
(((GE I LIMIT))) (IF (ZEROP C) 
(FN) ) ) () 
(LOOP-TEST () 5@88) (FD D) 
(TR A) 
CONS Test: (DE X () (CONS A A)) (POLY-SPIRAL (+ D1) (#A 4) (-C 1)))) 
(SET@ A *(1)) {POLY-SPIRAL 18 70 108) 


(LOOP-TEST X 5000) 

Graphic PolySpiral 2: 

Integer addition: (DE ADD-TEST () (+ A B)) (POLY-SPIRAL 18 78 200) 
(SETQ.A1 B 2) 
(LOOP-TEST ADD-TEST 5000) 


IQ Lisp Benchmark Programs 
Float addition: uses ADD-TEST 


(SETA A 1.2 B 234324, 3) Empty Loop Test: © (DEFUN LOOP-TEST 
(LOOP-TEST ADD-TEST 580) (LAMBDA (FN LIMIT) 
(LOOP (INITIAL I) 
Integer multiplication: (NEXT I (ADD1 I)) 
(DE MULTIPLY-TEST () (# A B)) (UNTIL (GE I LIMIT)) 
(SET@.A1 Be2) (DO (FN)) ) ) 
(LOOP-TEST MULTIPLY-TEST 50080) (LOOP-TEST () 5@0@) 
Float multiplication: CONS Test: (DEFUN X (LAMBDA () (CONS A A))) 
uses MULTIPLY-TEST (SETA A (QUOTE (1))) 
(SET A 1.2 B 234324. 3) (LOOP-TEST X 5000) 


(LOOP-TEST MULTIPLY-TEST 5000) 
Integer addition: (DEFUN ADD-TEST (LAMBDA () (+ A B))) 


Assignment: (DE ASSIGNMENT-TEST () (SETQ C C)) (SETA A 1) (SETQ B 2) 
(SET@ C '(i 2 3)) (LOOP-TEST ADD-TEST 5080) 
(LOOP-TEST ASSIGNMENT-TEST 5000) 

Float addition: uses ADD-TEST 


List Indexing: (DE LIST-INDEX () (NTH L 100)) (SETA A 1.2) (SETQ B 234324, 3) 
(SETAL'( 1234... 120)) (LOOP-TEST ADD-TEST 500) 


(LOOP-TEST LIST-INDEX 5000) 
Integer multiplication: 


Vector Indexing: (DE VECTOR-INDEX () (V 108)) (DEFUN MULTIPLY-TEST (LAMBDA () (# A B))) 
(SETA V (NEWVEC 128)) (SET A 1) (SET@ B 2) 
(LOOP-TEST VECTOR-INDEX 5002) (LOOP-TEST MULTIPLY4TEST 5000) 
String Indexing: (DE STRING-INDEX () (NTH S 108)) Float multiplication: 
(SETA S "123456789 .... 89") uses MULTIPLY-TEST 
(LOOP-TEST STRING-INDEX 5@82) (SETA A 1.2) (SETQ B 234324. 3) 


(LOOP-TEST MULTIPLY-TEST 5@02) 
Graphics Circle: (LOOP 368 (FD 1) (TR 1)) 


Assignment: (DEFUN ASSIGNMENT-TEST () (SETQ C C)) 
Graphics Square 1: (DE SQUARE (SIZE) (SETA C (QUOTE (1 2 3))) 
(LOOP 4 (FD SIZE) (LOOP-TEST ASSIGNMENT-TEST 500) 
(TR 98) ) ) 
(DE SQUARE-TEST-1 () List Indexing: (DEFUN NTH 
(SQUARE 100) ) (LAMBDA (LN I) 
(LOOP-TEST SQUARE-TEST-1 100) (SET@ I 1) 
(LOOP (INITIAL I 1) 
Graphic Square 2: (LOOP 100 (NEXT I (ADDL 1)) 
(SQUARE 100) (UNTIL (GE I N)) 
(TR 3) ) (DO (SET@ L (CDR L))) 
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(RESULT (CAR L)) ) ) ) 
(DEFUN LIST-INDEX (LAMBDA () (NTH L 108))) 
(SET L (QUOTE (1234... 128))) 
(LOOP-TEST LIST-INDEX 5000) 


(DEFUN VECTOR-INDEX (LAMBDA () (V 10@))) 
(SETG V (ARRAY 5 128)) 
(LOOP-TEST VECTOR-INDEX 5002) 


Vector Indexing: 


(DEFUN STRING-INDEX 

(LAMBDA () (SUBSTRING S 180 100))) 
(SETQ S "0123456789 .... 89") 
(LOOP-TEST STRING-INDEX 580) 


String Indexing: 


Dot and line functions are supported. 
Turtle graphics are not supported but could 
be implemented using existing functions. 
Not test programs were developed. 


Graphics: 


muLisp Benchmark Programs 


Empty Loop Test: (DEFUN LOOP-TEST 
(LAMBDA (FN LIMIT I) 
(SETQ I 1) 
(LOOP ((GREATERP I LIMIT)) 
(SET@ I (ADDI 1)) 
(FN) ) ) ) 
(LOOP-TEST () 5080) 
CONS Test: (DEFUN X (LAMBDA () (CONS A A))) 
(SETQ A (QUOTE (1))) 
(LOOP-TEST X 5000) 


Integer addition: (DEFUN ADD-TEST (LAMBDA () (PLUS A B))) 
(SETQ A 1) (SET@ B 2) 
(LOOP-TEST ADD-TEST 5808) 
Float addition: not supported 
Integer multiplication: 
(DEFUN MULTIPLY-TEST (LAMBDA () (TIMES A B))) 
(SET@ A 1) (SETQ B 2) 
(LOOP-TEST MULTIPLY-TEST 5000) 


Float multiplication: not supported 


Assignment : (DEFUN ASSIGNMENT-TEST () (SETQ C C)) 
(SETQ C (QUOTE (1 2 3))) 
(LOOP-TEST ASSIGNMENT-TEST 500) 
List Indexing:  (DEFUN NTH 
(LAMBDA (LN I) 
(SETQ I 1) 
(LOOP ((GREATERP IN) (CAR L)) 
(SET@ I (ADDL 1)) 
(SETA L (CDR L)) ) ) ) 
(DEFUN LIST-INDEX (LAMBDA () (NTH L 100))) 
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(SETO L (QUOTE (1234... 120))) 
(LOOP-TEST LIST-INDEX 5002) 
Vector Indexing: not supported 
(DEFUN STRING-INDEX 
(LAMBDA () (SUBSTRING S 108 108))) 


(SET S (QUOTE AQ123456789 .... 89)) 
{LOOP-TEST STRING-INDEX 5@8@) 


String Indexing: 


Graphics: Not supported 


micro-Prolog Benchmark Programs 


((LOOP-TEST X 1)) 
((LOOP-TEST X Y) 
(SUM Z 1 Y) 
X 
/ 
(LOOP-TEST X Z) ) 
((EMPTY-TEST) ) 
7((LOOP-TEST (EMPTY-TEST) 5@@@)) 


pty Loop Test: 


((CONS-TEST) (EQ (X 1 Y) (1))) 
7((LOOP-TEST (CONS-TEST) 5000) ) 


CONS Test: 


((ADD-TEST) (SUM 1 2 X)) 
Note: access of constant, not variables 
2((LOOP-TEST (ADD-TEST) 5@0@)) 


Integer addition: 


Float addition: ((FLOAT-ADD-TEST) (SUM 1.2 234342.3 X)) 


Note: access of constant, not variables 
7((LOOP-TEST (FLOAT-ADD-TEST) 5080) ) 


Integer multiplication: 
((MULTIPLY-TEST) (TIMES 1 2 X)) 
Note: access of constant, not variables 
9((LOOP-TEST (MULTIPLY-TEST) 5008)) 


Float multiplication: 
((FLOAT-MULTIPLY-TEST) (TIMES 1.2 234324.3 X)) 
Note: access of constant, not variables 
2((LOOP-TEST (FLOAT-MULTIPLY-TEST) 5088) ) 


not done since conventional assignment 
is significantly different from adding 
clauses into the data base. 


Assignment: 


(CINDEX (X | Y) 1 X)) 
(CINDEX (X 1 Y) Z Xi) 

(SUM Xe 1 7) 

/ 

(INDEX Y Xe X1)) 
(A1@123456789... 8 9)) 
((B X) (INDEX X 188 Y)) 
2U(A TX) 

(EQ Y (B X)) 
(LOOP-TEST Y 5080) ) 


List Indexing: 
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INTRODUCING THE LATEST IN 
HIGH QUALITY PRODUCTIVITY TOOLS 
FOR MICROCOMPUTER SOFTWARE 
DEVELOPERS AND PROGRAMMERS 


{SET} Tools — 


¢ Operate on most popular MS-DOS and CP/M systems. 
¢ Can be used with any source language. 

¢ Improve development productivity. 

¢ Provide assistance for the tedious task of maintenance. 


{SET:DIFS}™ Source File Comparator $139.00 


¢ Fast, smart and accurate 

¢ Use for regression testing, too 

¢ Difference display highlighting 
A/P/L Options available as add-ons to {SET:DIFS} to provide for minimized 
communications with the ADR or PanValet mainframe librarians or with {SET}'s Batch 
Line Editor, {SET:LIKE}. $20.00 per option 
{SET:LIKE} add-on to {SET:DIFS}. $40.00 


{SET:GXREF }™ Cross Reference Utility $79.00 


¢ Supplied parameter files allow use of any source language 
¢ Cross references multiple files at once 


{SET:PATCH}™ Object File Editor $79.00 


© Quickly apply changes to any file type 
¢ Hexadecimal and ASCII display and change entry 
e Easy to use with cursor and function keys 


{SET:SCIL}™ Source Code Interactive Librarian $349.00 
¢ Maintains history of changes 
¢ Reduces storage by identifying differences from level to level 
¢ Provides control over concurrent development efforts by detecting 
overlapping changes 
PC-Demo Disk and Manual available for $35.00 


{SET} Tools are available individually or, better yet, 
select a combination of tools to meet your specific needs. 


Multiple copy discount available. 


Get {SET} for Success 
{SE \ System Engineering Tools, Inc. 


645 Arroyo Drive « San Diego, CA 92103 


COD, Check with order, Master Card or VISA accepted. 


To order {SET} tools or for more information, call 
System Engineering Tools, Inc. (619) 692-9464. 


Vector Indexing: not supported 
String Indexing: strings over 6@ characters not supported 


Graphics: Not supported 


DR Logo Benchmark Programs 


Empty Loop Test: TO LOOP. TEST :FN :TIMES 
REPEAT :TIMES (RUN :FN] 
END 
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As we go to press 

New versions of muLISP and TLC 
Lisp have been released with major im- 
provements since the original work for 
this review was done. The following 
comments take these new versions into 
account. 

The latest version is muLISP-83 
which has a number of major enhance- 
ments. The documentation has been re- 
done using the Lisp syntax to formally 
define functions. More examples and 
comments have been added which 
make the documentation very good. A 
Maclisp and Interlisp compatability 
function library has been added to assist 
in software migration between other 
systems. An interactive, online intro- 
duction for novice users is included. 
This is a very good way to learn Lisp. 

A number of enhancements and 
corrections have been added to the new 
implementation. Assembly language 
routines can be added along with a table 
driven scanner/reader which includes 
various types of read macros. Error 
handling has been vastly improved and 
the CATCH/THROW constructs have 
been added. Even random file I/O is 
included. The maximum integer preci- 
sion is now limited to 64 kbytes per 
number (which is large by any mea- 
sure). 

Although muLISP does not support 
windows or graphics directly, lesson 
#6 of the tutorial shows how to imple- 
ment basic turtle graphics using DOS 
interrupts and ROM routines in the 
IBM PC. 

The memory allocation is slightly 
different than described in the article. 
List space is limited to 128 kbytes (32K 
list cells) while D-code resides in a 
separate area which can be up to 60 
kbytes. Garbage collection speed has 
been improved. 

TLC-Lisp also has a number of im- 
provements including new documenta- 
tion and a real compiler. The compiler 
typically doubles the speed and cuts the 
code size from thirty to fifty percent. 
The turtle graphics drawing speed has 
also doubled. 

The class system has been im- 
proved and so has the resident screen 
editor. In fact, the compiler can be in- 
voked directly from the editor with two 
keystrokes. Full PC-DOS 2.x file ac- 
cess is supported including subdirec- 
tory support. 

Versions are available for PC- 
DOS, MS-DOS and CP/M-86. 
Graphics are available for the IBM PC 
and compatible machines. 

A new version of micro-Prolog has 
also been released which supports an 
assembly language interface. It also 
comes with a DEC-10 ProLog emula- 
tion mode. 
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TO DO. NOTHING 
END 
LOOP. TEST (DO. NOTHING] 5002 


CONS Test: TO CONS. TEST 
(LOCAL "T) 
MAKE "T FPUT :A :A 
END 
MAKE "A [1] 
LOOP. TEST CCONS. TEST] 5008 


Integer addition: TO ADD. TEST 
(LOCAL "T) 
MAKE "T :A + 3B 
END 
MAKE "A 1 
MAKE "B 2 
LOOP. TEST CADD. TEST] 5008 


Float addition: MAKE "A 1.2 
MAKE "B 234324. 3 
LOOP. TEST CADD. TEST] 580d 


Integer multiplication: 
TO MULTIPLY. TEST 
(LOCAL "T) 
MAKE "T 3A # 3B 
END 
MAKE "A 1 
MAKE "B 2 
LOOP. TEST CMULTIPLY. TEST] 5008 


Float multiplication: 
MAKE “A 1.2 
MAKE "B 234324.3 
LOOP. TEST (MULTIPLY. TEST] S000 


Assignment: TO ASSIGNMENT. TEST 
MAKE "C :C 
END 
MAKE "C [i 2 3) 
LOOP. TEST CASSIGNMENT. TEST] 5000 


TO LIST. INDEX. TEST 
(LOCAL "T) 
MAKE "T ITEM 188 A 
END 
MAKE "A (@123456789... 89] 
LOOP, TEST CLIST. INDEX. TEST] 5008 


List Indexing: 


Vector Indexing: not supported 


String Indexing: TO STRING. INDEX. TEST 
(LOCAL "T) 
MAKE "T ITEM 108 A 
END 
MAKE "A "AB123456789 .... 89 
LOOP. TEST CSTRING. INDEX. TEST] 5000 


Graphics Circle: REPEAT 368 [FD 1 RT 1] 


Graphics Square 1: TO SQUARE :SIZE 
REPEAT 4 [FD :SIZE RT 98) 
END 
TO SQUARE. TEST. 1 
SQUARE 108 
END 
LOOP. TEST CSQUARE. TEST. 1] 108 


Graphic Square 2: REPEAT 10@ (SQUARE. TEST.1 RT 3) 


Graphic PolySpiral 1: 
TO POLY-SPIRAL :D :A :C 


TEST :C = @ 
IFFALSE (FD :D 
RT :A 
POLY. SPIRAL :D +1 
A+ 1 
C - 1) 
END 


POLY. SPIRAL 18 70 108 


Graphic PolySpiral 2: 
POLY. SPIRAL 18 7 200 


expandable housing systems for most S-100 BUS configurations. 
Whether a rack mount, desk top, or stand alone, our patented super- 
efficient heat dissipation system can end your board-level failures due to 


high temperatures. Please call today for full details. (602) 991-1600 
PARA DYNAMICS CORPORATION @ 7895 EASTACOMA e SCOTTSDALE, AZ 85260 


Poor Person Software 


Introduces 


Write-Hand-Man 


Desk accessories for CP/M 


Write-Hand-Man [ets you take notes, check phone 
numbers, make appointments, and countless other tasks 
without leaving Wordstar, dBase, Multiplan, or any other 
application. Enter Write-Hand-Man with a single key- 
stroke and choose the program you want. When you 
leave Write-Hand-Man, your application continues 
normally. 


$49.95 plus tax delivers Write-Hand-Man and 4 
companion programs; Notepad, Phonebook, Calendar, 
and Termcomm. User written programs are easily added. 
All you need is M80 or some other LINK-80 compatible 
assembler. 


Other CP/M products available from Poor Person Software: 
Poor Person’s Spooler ($49.95), Poor Person’s Spelling Checker 
($29.95), Poor Person’s Spread Sheet ($29.95), Keyed Sequential 
Files ($39.95), Poor Person’s Menus ($29.95), aMAZEing Game 
($29.95), Window System ($29.95), Crossword Game ($39.95), 
Mailing Label Processor ($29.95). Shipping included. 


All products available on IBM 8 inch and Northstar 5 inch disks. Other 5 inch 
formats add $5 handling charge. No credit cards. 


Poor Person Software 
3721 Starr King Circle 
Palo Alto, CA 94306 
tel 415-493-3735 


CP/M is a registered trademark of Digital Research 


C Programmers: 
File System Utility Libraries 


Source Code Included, No Royalties, 
Powerful & Portable. 


BTree Library $7 Rie 


High speed random and sequential access. 
Multiple keys per data file. 

Up to 16 million records per file. 

Full documentation and example orograms inciuded. 


‘ 00 
ISAM Driver $40. 
Works with the BTree Library. 
Greatly speeds application development. 
Combines ease of use of database manager with flex- 
bility of programming language. 
Supports multi key files and dynamic index definition. 


Very easy to use; fully documented; example pro- 
grams included. 


Both products 


Are written entirely in K&R C. 
Come with complete source code. 
Are free of any royalty charges. 


+ $3.00 Shipping & 
Handling Charge. 


For more information call: : 
1277 Pallatine Drive 


Oakville, Ontario, Canada 
L6H 121 
(416) 844-2610 


Credit cards accepted. Dealer inquiries invited. 


THE WORLD’S FASTEST 
S-100 2-80 SLAVE PROCESSOR 


TurboSlave I 


8 Mhz Z-80H e 128k Ram with parity 


Data transfers to 1 e 2 RS-232 Ports. 
mbyte/second 50-38.k baud 

S100 IEEE-696 compatible e F.IF.O. communications 
4k Monitor rom e On board diagnostics 
Low parts count e Low power consumption 
No paddle boards e TurboDOS compatible 


GUARANTEED COMPATIBLE WITH ALL S-100 SYSTEMS 
RUNNING TURBODOS 


INTRODUCTORY PRICE $495 


Includes TurboDOS drivers (a $100 value) and 
TurboSlave | with 128k ram. 


= 
SSS 
Cw) EARTH COMPUTERS 
a 
oe 


P.O. Box 8067, Fountain Valley, CA 92728 
TELEX: 910 997 6120 EARTH FV 


FOR MORE INFORMATION AND QUANTITY DISCOUNTS 


CALL: (714) 964-5784 
Registered trademarks: Z-80H, Zilog Inc.; TurboDOS Software 2000, Inc. 


GRAF 2.0 ®29.95 


GRAF 2.0 allows you to create amazing graphics on your dot- 
matrix printer. Features include: 


* Automatic bar chart and line graph generation 

* Automatic scaling and labeling of both axes 

* Ability to plot floating-point data obtained from most 
spreadsheets, word processors, or languages. 

* Extensive, 60-page illustrated User's Manual includes 
examples showing how to do graphics from SuperCalc, 
dBASE Il, MBASIC, and Turbo Pascal. 


THEORY vs EXPERIMENT 
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time (seconds) 


System Requirements Any Z80 computer running 60k CP/M and 
driving an Epson, Gemini, or C. Itoh dot-matrix printer. 


Microcomputer 


MSC “scm 


Consultants 


301 North Harrison Street CN 5279, Suite 228 Princeton, New Jersey 08540 
Terms Send check or money order for $29.95 + $5.00 s/h to 
MSC at the address above. You MUST state your computer 


and printer make and model. NJ residents add 6% tax. 


The following are trademarks oc regustered trademarks of the indicated companiem CP/M - Digntal Research, MBASIC - MicroSoft, 
Supercale - Sorcim, Turbe Pascal - Rortand International, 4BASE Il - Ashton-Tate, 280 ~ Zilog, Kaypro ~ aypro Corporation 


MODEL 256KM 


i] 


e ae T S02 


MODEL FOC-1 


BUFFERED I/O BOARD 


For $100 bus by S. C. Digital, Inc. 


256 K/1M DYNAMIC RAM Board Model 256KM $795 

@ 256K/1M bytes using 64K or 256K DRAMs ®@ 8/16b data @ 24b Address 
@ Parity per byte @ 175nsec access time @ willrun Z80/Z8000 to6 mhz, 8086, 
80186, 68000 to 8mhz without wait states @ transparent refresh, unlimitted DMA 
@ with 1MB using 256K drams. 


256K/1M DYNAMIC RAM BOARD Model 256KB-256 $459 

@ 256K/1M bytes using 64K or 256K DRAMs @ 8b data @ 16 of 24b address 
© parity per byte © Memory mapping in 16K blocks @ 175 nsec access time @ 
Addressable in 128k, 192k, or 256k boundaries, compatible with Z-100* systems 
@ with 256KB using 256K drams, expandable to 1 mega byte, less memory map- 
ping @ add $20 for memory mapping. 


FLOPPY DISK CONTROLLER Board Model FDC-1 $375 

@ Single or double sensity, sides, in any combination of up to four 8’ or 5'4"" drives 
© Digital phase-locked loop @ DMA data transfer with cross 64K bountaries, 24b 
address, DMA arbitration © built in monitor/boot EPROM that accomodates two 
different processors @ serial port to 19.2Kbaud @ uses 765A/8272 @ with 
CPM bios programs 


8086 CPU Board Model 8086 CPU $375 

@ 8/4 mhz SW selectable @ 8087 interface @ provision to fun two processors 
on a bus such as our Z80 CPU @ convertable to 10, 12mhz clock @ optimized for 
DRAM boards. 


80286 CPU Board Model 80286 from $350 

@ 8/4 mhz switchable @ 80827 interface @ provision to run two processors on 
abus @ convertableto8mhz @ separate built in colck for80287 @ optimized for 
DRAM boards, 


S.C. DIGITAL, INC. 


SUPPORT Board Model Support-1 $395 

@ 4 serial, full handshakes, two with software programmable baud rates @ Cen 
tronics @ SASI interface @ Real/interval times @ Calendar-clock with battery 
backup @ expandable interrupt controllers for 8086 or 8080/Z80 @ CPU switch 
ing to run 2 processors on a bus such as our 8086 or 80286 and Z80 CPU 
boards. 


1/0 Interface board Model 3SPC-N $229 
@ 3 serial RS-232C with switch selectable baud rates, 110 to 19.2kbaud. 
@ 1 parallel. 


Board Sets: 8086, 256KM (with 512KB), FDC-1, 3SPC-N 
780, 256KB-256, FDC-1, 3spc-N $1150 


$1388 


S-100 COMPUTER ‘System 16” $3200 

8086 based at 8mhz, with512kb, 5 serial ports, 1 centronics, 1 SASI, battery backed 
calendar clock, real time clock, interrupt driven, 10 slot card cage, two5.25" floppy 
drives with 500 kb transfer rates and 1.2 mbyte storage each, with CPM 86 operating 
system (Concurrent Dos available soon). Cabinet has room for full size 51’ 
hard disk. 


Operating Systems available: CPM 2.2, CPM 3.0, CPM 86, MSDOS. 


*CPM is registered trade mark of Digital Research Inc. Z-100 is registered trade mark 
of Zeith Corporation. 


Please call for latest prices. 
Prices subject to change without notice. 


1240 N. Highland Ave., Suite4 @ P.O. Box 906, Aurora, Illinois 60507 


Phone: (312) 897-7749 


Introductory Price * $59.95 


With despool functions, protocols supported: XON/XOFF, ETX: ETB/ACK 


Serial /0 


110-19200 Baud 


80 CHARACTER VIDEO BOARD 
25 Lines with status, compatible with Wordstar & dBase 


Composite 


Serial 1/0 
110-19200 Baud 


NEW PRODUCTS 


SERIAL ADAPTER FOR THE VDB-A2- 


Plugs into keyboard socket 

Direct connect to Keytronic (IBM) serial 
ASCII keyboard 

Internal speaker for BEEPER 


2K Program EPROM 
Programmable Functions 
Dynamic Buffering 


Tx port for non VDB-A2 use 
Hardware programmed Rx & Tx 
Dual baud-rate generator 


Bare-board OR assembled 


2716 Cha 
Generator 
EPROM 


e 
2716 Alternate | | Bey) Keyboard 
Character Out Parallel 
Gen. EPROM Port 


8275 CRTC 
Reverse Video 
Highlight, Blink 


DOUBLE-HEIGHT S-100 PROTOTYPING- 


Oversized heatsinks for Hl-CURRENT 
reg’s: +5, +/-12 V. 

Use with wire-wrap sockets OR direct 
solder connections 


GOLD plated edge connector 
NO PLATING CUTS required 


S-100 Interface 
8 Bit 1/0 
Addressing 


NO wasted address decoding 


WATCH OUR ADS FOR 


Includes Bareboard, Heatsink & Documentation Call or write for more information. 


Stmpliway Products Ca. 


P.0. Bor 601 — 
(7) Wolfman Estates, 1L.60095 4 
(312) 359-7337 a 


OEM dealer pricing available, $3.00 S/H, IL. Res. add 7% tax 
dBase™ - of Ashton. Tate Corp. — Wordstar'™ - of Micropro Int'l. Corp 
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OTHER PRODUCTS COMING SOON 


e MODEM ADAPTER FOR THE BIO-1 

e 256K RAM SOFTWARE FOR BIO-1 

¢ HIGH FEATURE DISC CONTROLLER 
e Z80 C.P.U. / MEMORY MANAGER 

¢ 1 MEGABYTE DRAM BOARD 


Specifications subject to change without notice 
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Loadable BIOS 
Drivers For 


CP/M 


Introduction 

One reason that CP/M is such a 
popular operating system for small 
computers is its interaction with a user 
provided I/O system. This standard in- 
terface to the computer hardware 
means you can run CP/M on anything 
that executes the 8080 instruction set. 

In the early days when floppy disks 
were all 8 inch single density, a CP/M 
BIOS was a fairly simple piece of code. 
About all you needed were routines to 
read and write a disk sector and interact 
with one or more serial lines for I/O. 
With the coming of double density (and 
double sided) disks and mini-floppies 
and Winchesters, the complexity of the 
BIOS has become such that it is usually 
supplied as an integral part of a pre- 
configured computer system. 

As a result, a great many CP/M 
users tend to shy away from changing 
their BIOS code; and for good reason. 
Since it is so complex, it is often diffi- 
cult to make changes without introduc- 
ing disastrous side effects. There are 
many cases, however, where a mod- 
ified BIOS handler for an I/O device 
can enhance a specific application. 

No matter how complex a BIOS 
may be, it’s basic interface to the CP/M 
operating sytem remains the same. The 
same I/O subroutines are provided, and 
their entry points are defined by a fixed 
jump table. This article presents some 
ideas on how to provide your system 
with what might be called ‘‘loadable 
drivers’’ by using these fixed entry 
points. The more critical code (like disk 
I/O) can be left unchanged while new 
handlers for other things (like the con- 
sole, list, reader, etc.) can be modified 
to suit an application. 

Using the methods described here, 
you can write and test new BIOS hand- 
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by Cal Sondgeroth 


Add or change 
BIOS code at hoot 
time without 
changing the BIOS 
code itself. 


lers on an individual basis and run the 
new system without modifying a line of 
the original BIOS source. In fact, if you 
know how to interact with the I/O de- 
vices you want to control, you don’t 
even have to have the source code for 
your BIOS. 

Every time you do acold start, your 
machine is back to using the original 
vendor supplied BIOS until you load 


one or more of your new drivers tor 
special applications. This means that 
you can debug a device handler by 
making changes, re-compiling and test- 
ing without all the hassle of re- 
compiling an entire BIOS, patching it 
into CP/M and doing a system genera- 
tion. 


The BIOS entry point jump table 

At the start of every BIOS, there is a 
table of 17 jump instructions. These 
jumps are placed in a fixed order and 
each one goes to the start of the internal 
code that handles a specific I/O func- 
tion. Since CP/M always knows where 
the BIOS starts, it can access the device 
handlers by referencing these absolute 
address jumps with a call instruction. 
Each handler exits via a return to CP/ 
M. 

The jump table looks like Figure 1. 


Looking at the jump table in Figure 
1, you can see that in order to provide a 
different handler for one of the BIOS 
routines, all you need to do is get the 


Offset Jump Instruction 
+0000 JMP COLD 
+0003 JMP WBOOT 
+0006 JMP CONST 
+0009 JMP CONIN 
+000C JMP CONOUT 
+000F JMP LIST 
+0012 JMP PUNCH 
+0015 JMP READER 
+0018 JMP HOME 
+001B JMP SELDSK 
+001E JMP SETTRK 
+0021 JMP SETSEC 
+0024 JMP SETDMA 
+0027 JMP READ 
+002A JMP WKITE 
+002D JMP LISTS 
+0030 JMP SECTRAN 


Description of handler routine 


;COLD START INITIALIZATION 
;WARM BOOT OPERATION 

;CONSOLE CHARACTER READY STATUS 
;READ CONSOLE INPUT CHARACTER 
;SEND C-REGISTER TO CONSOLE 
;SEND C-REGISTER TO LIST DEVICE 
;SEND C-REGISTER TO THE PUNCH 
;RKETURN NEXT READER CHARACTER 
;DISK SEEK TO TRACK 00 

;SELECT DISK IN C-REGISTER 

;SET TRACK FROM BC REGISTERS 
;SET SECTOR FROM BC REGISTERS 
;SET DISK I/O ADDRESS (BC) 
;READ TRACK AND SECTOR 

;WRITE TRACK AND SECTOR 

;RETURN LIST DEVICE STATUS 
;CONVERT LOGICAL TO PHYSICAL SECTOR 


Figure | - CP/M BIOS Entry Point Jump Table 
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new handler in memory somewhere 
and change the table jump so it goes to 
the new code rather than the original 
code inside the BIOS. Of course this 
assumes that your BIOS is in RAM 
memory. If your computer has the 
BIOS permanently coded in ROM, the 
ideas presented here are not of much 
use. 
Finding a place to put the new I/O 
driver can be a problem if your version 
of CP/M uses all of memory as is usual- 
ly the case. Unless there is some unused 
memory at the top of the BIOS, you are 
out of luck. 

A possible solution is to regenerate 
CP/M for a smaller memory size. That 
would leave some space above the 
BIOS for your new driver. The dis- 
advantage of this of course is that the 
memory space is always used whether 
you have a BIOS extension or not. The 
relocatable drivers described here 
allow you to use the maximum memory 
space on your machine reserving only 
the amount necessary to contain the 
new driver when you install it. 

If you can find some memory to use 
and want to try modifying one of the 
BIOS routines, you can write the new 
handler with an absolute origin and 
assemble it. Then write a CP/M prog- 
ram that loads the new code and 
changes the BIOS jump accordingly. 


Using the transient program area for 
driver code 

If we look at the CP/M memory 
map (see the left hand side of Figure 2) 
there is a huge section of memory that is 
used for processes that run as normal 
programs. If there were some way to 
put our new driver code up in the high 
part of this memory, and then do some- 
thing so it would not get destroyed by 
other programs, we could run the driver 
code there with only a small impact on 
the total memory. 

Most CP/M programs use every- 
thing from 0100H right on up to the 
base of the CP/M BDOS. That is they 
can overwrite the Console Command 
Processor since it is reloaded when the 
program exits via a warm boot opera- 
tion. Such a program could destroy any 
driver code placed at the top of the 
TPA. 

There is a way out, however. All 
CP/M transient programs are written so 
they automatically adjust themselves to 
use the maximum amount of memory 
available. In these days of cheap mem- 
ory it is sometimes easy to forget that 
you don’t have to have 64K to run alot 
of CP/M stuff. Indeed, the standard 
V2.2 system is set up for a 20K 
machine — lots of memory in 1979. 

To find out how much memory is 
available to it, a program examines the 
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target address of the jump instruction at 
location 0005H; the constant system 
call entry point. Since this jump goes to 
the start of the BDOS, its target address 
is the lowest address needed by CP/M 
to run the application. The CCP can be 
destroyed since it plays no part in tran- 
sient program operation. 

It would seem that if we modified 
the location 0005H jump so it went 
somewhere below the base of the 
BDOS, we could allocate some mem- 
ory (like for the drivers we want to add) 
and it would not be overwritten by other 
programs. All we would need then is 
another jump instruction at the begin- 
ning of the allocated memory that con- 
tinues on to the real BDOS entry so 
calls to location 0005H would reach it 
like always. Since CP/M programs 
would find the lower target address in 
the jump at 0005H they would think 
they were running in a smaller size sys- 
tem and adjust their memory useage 
accordingly. 

To make sure the memory remains 
protected, there is one more thing that 
needs to be done. Since a warm boot 
usually reloads all of the operating sys- 
tem from the start of the Console Com- 


mand Processor up to the start of the 
BIOS and resets the location 0005H 
jump as part of the process we have to 
supply a new warm boot routine for the 
BIOS. Otherwise, the location 0005H 
jump would be set back to normal on 
the first warm boot after we tried to 
allocate some memory, and the next 
program to run would not know about 
it. The sample BIOS extension below 
provides a warm boot handler that takes 
care of this. 

Since the warm boot no longer re- 
loads the operating system, the CCP is 
kept in memory all the time so it is 
available to process command lines. 
Memory for the loadable drivers is set 
up just below the base address of the 
CCP. 

The right hand side of Figure 2 
shows a memory map of CP/M with a 
driver module installed just below the 
CCP. Note how the jump instruction at 
OO05H in that map goes to the start of 
the driver. The driver starts its code 
with a jump instruction that continues 
on to the normal BDOS entry point. We 
will see later how all of this code gets 
loaded and the jump instructions are 
changed so they go to the right places. 


| JMP CONIN H 
| JMP CONST ! 
! JMP WBOOT <------------- ‘ 
| JMP COLD { 


Console Command | 
Processor ; 
(ccr) H 


Transient Process 
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Memory Map for CP/M 
(Unmodified) 


iJMP ECONST----- Deen------ + 
{JMP EWBOOT----- Penne nn- n-ne + 
tJMP COLD H 


1 Console Command H 
j Processor H 
H (CCP) H 


| BIOS Extension 
{ Module Code 
1 
1 


\JMP XCONIN<----------- 
1JMP XCONST<----------- 
\JMP XWBOOT<----------- 
+---->JMP BDOS 


' 
' 
1 
’ 
i 
| Transient Process 
i Area (TPA) 
1 
' 
t 
{ 
1 


' 
H I 
+0005!JMP BIOS Extension | 
0004!CDISK { 
0003/IOBYTE H 
0000!}JMP BIOS+3 (WBOOT) } 


Memory Map For CP/M 
With BIOS Extension 


Figure 2 - CP/M Memory Maps 
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Getting the driver code installed 

The example BIOS extension and 
the relocatable loader program make 
use of the Digital Research RMAC re- 
locatable assembler and LINK linking 
loader. They allow you to write a BIOS 
driver and load and relocate it to run in 
any size CP/M system putting it just 
below the CCP no matter where that 
happens to be. If you don’t have access 
to RMAC and LINK you can write your 
driver so it is origined at a fixed address 
below the CCP. Then you will need to 
write an absolute loader program to in- 
stall it and fix the jump instructions. 

Using the relocating loader is much 
cleaner. It automatically allocates just 
enough memory to hold the driver and 
is not bound to any absolute addressing; 
the extension is automatically loaded 
and relocated to run at its new address. 


System page relocatable files 

The Digital Research LINK utility 
has an output option that produces this 
type of file rather than an absolute 
COM file that runs in the TPA. A sys- 
tem page relocatable file has a type of 
““SPR’’ and contains object code that is 
origined at a base address of OOOOH. It 
also has a map that indicates which 
bytes of the code have to be adjusted if 
they are moved so the module base 
address is other than 0000H. The only 
restriction on relocating the code and 
running it elsewhere is that it be moved 
to an even page boundary; i.e., starting 
somewhere at X XOOH, where XX is the 
high byte of the new address. This is so 
because the relocation map only indi- 
cates that a high byte of the code is to be 
adjusted when it is moved; the low 
bytes remain the same as they were 
when it was origined at OOOOH. 

A dump of the system page relocat- 
able file for the sample BIOS extension 
module is shown in Figure 3. The first 
256 bytes contain information about the 
sizes of the various sections of the prog- 
ram. For our purposes, we will only be 
concered with the size of the code sec- 
tion. This is found in the 2nd and 3rd 
bytes of the first page (256 bytes) of the 
file. In this case byte 2 (the low part) is 
0A3H and byte 3 (the high part) is OOH, 
so the number of bytes of object code in 
the file is OOA3H, or 163 bytes. 

The actual object code begins in the 
2nd 256 byte page of the file, starting at 
address 0200 in Figure 3. You can see 
the jump table at the beginning of the 
BIOS extension module there. 

The thing that makes relocation of 
the object code possible is the bit map 
that starts at the first byte after the ob- 
ject code. In Figure 3 it is at address 
02A3 (the start of the object code plus 
its size). The map is set up so that when 
one takes each byte and shifts the bits 
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DDT 
-1XB 


0300 
-D10 


VERS 2.2 
I0S.SPR 


CODE SIZE 


PC 
0100 
0,2FF 
00 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
45 00 C3 48 
00 C3 57 00 
C3 00 00 C3 
00 00 C3 00 
00 C3 00 00 
C3 00 00 31 
06 00 11 89 
19 3A 04 00 


00 
C3 
00 
00 
01 
09 


1A A. 
1A 
1A 
1A 


1A 


1A 
1A 1A 
1A 1A 
1A 1A 
1A 1A 


00 00 00 00 
1A 1A 1A 1A 
1A 1A 1A 1A 
1A 1A 1A 1A 
1A 1A 1A 1A 


Figure 3 - XBIOS.SPR File Dump 


PEP CSREES EELS SESE SECRETE EEE ESSE ETE eee eee ee ec ere sy 
# * 
* # 
* * 
PERE SEALE REESE SESE EEE EEE EEE SESE SSE EEE SESE REESE SEES S EES SS 
* 


x B I 0) Ss 


: A LOADABLE BIOS DRIVER MODULE FOR CP/M VERSION 2.2 a 
* BY: CAL SONDGEROTH # 
* 800 FIFTH AVENUE * 
s MENDOTA, IL. 61342 * 
* # 
CER SERESESE REE ELE EEE ESSE SERS EE ES ETSI EEE EET ERSTE EEE SS SE 
* REV | DATE H DESCRIPTION * 
#----- +o-------e +e------- meee + # 
# 1.0 {| O2JAN84 | INITIAL LOADABLE BIOS MODULE CODE * 


PRPS SRSSASEASELE SESE SESE TERS ERE ES ESET ERECT RES SSE TST EST TSS 


CE$..1$.1 


OBJECT 
CODE 


Miiillollipros’ 
EXTENSION IN PLA 


seeeee 


RELOCATION 
BIT MAP 


TITLE "LOADABLE BIOS MODULE FOR CP/M V2.2! 

PAGE 58 
CR EQU ODH sASCII CARRIAGE RETURN CHARACTER 
LF EQU OAH 3;ASCII LINE FEED CHARACTER 
CDISK EQU OOO4H 3CP/M DEFAULT DISK VARIABLE 


PRINTF EQU 9 


;BDOS PRINT STRING FUNCTION 


; THE FOLLOWING JUMP TABLE IS USED TO DEFINE NEW ENTRY POINTS 
3; FOR THE BIOS ROUTINES THAT ARE TO BE MODIFIED. 
3; THAT ARE NOT PART OF THE LOADABLE BIOS JUMP TO THE ORIGINAL 


; BIOS SUBRO 
BDOS JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 


UTINE ENTRY POINTS. 


$-$ 
XWBOOT 
CONST 
CONIN 
CONOUT 
LIST 
PUNCH 
READER 
HOME 
SELDSK 
SETTRK 
SETSEC 
SETDMA 
READ 


ANY ROUTINES 


;CONTINUATION JUMP TO CP/M BDOS 
;WARM BOOT ROUTINE FOR LOADABLE BIOS 
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JMP WRITE 

JMP LISTS 

JMP SECTRAN 

PAGE 
WHEN THE LOADABLE BIOS IS FIRST INSTALLED IN MEMORY, THE 
CONTENTS OF THE ORIGINAL CP/M BIOS JUMP TABLE ARE COPIED 
INTO THE FOLLOWING TABLE IN THE LOADABLE BIOS. THESE JUMPS 
PRESERVE THE ENTRY POINTS FOR ANY BIOS HANDLERS THAT ARE 
NOT GOING TO BE CHANGED. 


COLD JMP $-$ 
WBOOT JMP $-$ 
CONST JMP $-$ 
CONIN JMP $-$ 
CONOUT JMP $-¢ 
LIST JMP $-$ 
PUNCH JMP $-$ 
READER JMP $-$ 
HOME JMP $-$ 
SELDSK JMP $-$ 
SETTRK JMP $-$ 
SETSEC JMP $-$ 
SETDMA JMP $-$ 
READ JMP $-$ 
WRITE  JMP $-$ 
LISTS  JMP $-$ 
SECTRAN JMP $-$ 


REESE REESE EEE EERE E REE RRR E EERE ER EEE 


: THE FOLLOWING ENTRY POINT IS USED TO HANDLE THE CP/M WARM 

; BOOT WHEN A LOADABLE BIOS MODULE IS IN USE. THIS ROUTINE 

; SHOULD ALWAYS BE INCLUDED IN A LOADABLE BIOS. IT BYPASSES 
; THE RELOAD OF THE OPERATING SYSTEM AND REINITIALIZATION OF 
; THE LOW MEMORY JUMP VECTORS THAT*ARE PART OF A NORMAL CP/M 
; VERSION 2.2 WARM BOOT. 

XWBOOT EQU $ 


LXI SP,0080H ;RESET THE STACK POINTER 


LXI B,0080H ;AND SET DMA ADDRESS TO 

CALL SETDMA 3;GO TO CP/M DEFAULT I/O AREA 

LXI H,BDOS ;RESET THE LOCATION O0005H JUMP 
SHLD O0O06H ;TO GO TO OUR LOADABLE BIOS CODE 
LXI D,WBMSG ;OUTPUT A MESSAGE TO INDICATE 
MVI C,PRINTF ;LOADABLE BIOS IS IN PLACE 

CALL BDOS 

LHLD 0001H ;FETCH BIOS+3 ADDRESS AND THEN 


LXI D,-1600H ;COMPUTE THE ADDRESS OF THE 


DAD D ;CONSOLE COMMAND PROCESSOR PLUS 3 


LDA CDISK ! MOV C,A ;FETCH CURRENT DISK 
PCHL ;AND VECTOR INTO THE CCP 


WBMSG DB CR,LF,'BIOS EXTENSION IN PLACE$! 


POO UU CCUUCCUSE SECS S TCS C CESSES TET TTT TEE TRE 
* # 
* X L oOo A D x 
* * 
POU UPC CECCCCCCCCASE CESS SACS E SEE ES ESE SSS STE E EET E CES TTT TS 

* 
* 


x BIOS EXTENSION LOADER TRANSIENT PROCESS . 
* 

* BY: CAL SONDGEROTH * 
* 800 FIFTH AVENUE * 
* MENDOTA, IL. 61342 . 
* 

PoP ESE SESESSESELES ESE RSS EEE SS eee eee Tee ES ERE SEER RS EEE SS 
* REV | DATE | DESCRIPTION * 
oe Fa pecrecianicsianteess fiw dcwentacewccnonsacs tessa SacmeaceeceeeS * 
* 1.0 | O2JAN84 | INITIAL XBIOS MODULE LOADER CODE * 


HERE EEEEKE EKER REE EERE ERE ERE RHEE HE KEE H KR EKER HERE HRHKE 


TITLE 'XLOAD - BIOS EXTENSION LOADER! 


PAGE 58 
BOOT EQU O0O00H ;WARM BOOT ENTRY 
BDOS EQU 0005H ;DOS ENTRY ADDRESS 
FCB EQU OO5CH ;DEFAULT FILE BLOCK 
CONOUT EQU 2 ;CONSOLE OUTPUT FUNCTION 
OPEN EQU 15 ;BDOS OPEN FUNCTION 
SETDMA EQU 26 ;BDOS SET DMA ADDRESS 
READ EQU 20 ;BDOS READ SEQUENTIAL 
ORG 0100H ;CP/M TRANSIENT PROCESS 
XLOAD EQU $ 
LXI H,O ! DAD SP ;SAVE CP/M'S STACK POINTER 
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CREE SEES SECS C REESE See TET TEESE SET ETE SESE RESETS EDS 8 


out to the left one at a time for each byte 
of object code, a one indicates the byte 
must be modified (relocated) by adding 
the page offset of the place where the 
code is to run. If a map bit is a zero, 
then the corresponding byte can be 
moved without modifying it. 

So, to install a driver from its SPR 
file we move its object code to the de- 
sired location and use the bit map to go 
through and modify any bytes that are 
the high part of address dependent 
code. This whole process is very simi- 
lar to the scheme of assembling a 
source file twice; first with an origin of 
O100H and next with an origin of 
0200H and comparing the bytes in the 
two hex files to determine which need 
to be relocated when the code is moved. 
The system page relocatable file output 
option of the LINK utility does this 
automatically producing the object 
code plus the relocation information. 


Sample BIOS extension module 

A source code listing (XBIOS) is 
included here. It is assembled with the 
RMAC relocatable assembler. There 
are no ORG statements; its code begins 
at 0000. 

The sample module starts with a 
completely new jump table. These are 
the entry points that CP/M will use after 
the extension has been loaded and relo- 
cated. 

Note the first jump. It is coded as 
‘‘JMP $-$’’ without a specific address. 
This is the one that continues on to the 
BDOS as described above. The target 
of this jump gets filled in by the loader 
program (XLOAD) described below. 
XLOAD determines the size of the CP/ 
M system and inserts the correct 
address. This first jump replaces the 
normal BIOS cold start entry which is 
not used after the initial power up reset. 

The second jump goes to a routine 
called ‘“XWBOOT””’. This is the hand- 
ler that takes care of the warm boot 
operation when the loadable driver is 
present. It will be part of every BIOS 
extension you use, and it does every- 
thing except read the operating system 
from the disk system tracks. Note that it 
resets the location 0005H system entry 
jump, but to the base address of the 
driver module to maintain it in 
memory. 

Since the sample extension does not 
have any code for modified handlers, 
the other jumps go to the original BIOS 
handlers, so they remain unchanged. 
Of course you would code the appropri- 
ate jumps to go to any new handlers that 
you include in an extension module. 
You can assemble and install the sam- 
ple XBIOS. The only difference you 
will find is the ‘‘EXTENSION IN 
PLACE”’ message on each warm boot. 
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Also, you will probably notice that a 
warm boot goes faster since there is no 
disk read on the system tracks. When 
you write your own driver extensions, 
you can change the warm boot message 
to identify the driver. 


The original BIOS jump table 

In the sample extension, there is a 
second jump table immediately after 
the new jump table at the beginning. 
The loader program copies the existing 
BIOS jump table into this area. The 
purpose of that of course is to maintain 
access to all of the original BIOS 
routines. You will probably only be 
using one or two modifications, so you 
want to be able to access the other hand- 
lers and not disturb them. If your exten- 
sions need to refer to the original BIOS 
handlers, they can do so through the 
labels in this table. 

After it is safely copied away, the 
loader program modifies the original 
BIOS jump table so its entries go to the 
jump table at the start of the extension 
module. Thus when CP/M calls the 
BIOS, it still accesses the same 
address, but the jump goes to the new 
BIOS jump table. In some cases, that 
will go on to the normal BIOS handler. 
If there is a new module in the exten- 
sion, it will be used. 


Building a BIOS extension 

In order to get a loadable extension 
module for the sample XBIOS or one 
you write, first assemble it with the 
RMAC assembler: 


A>RMAC XBIOS <CR> 


That will produce a relocatable file 
XBIOS.REL. Then give XBIOS.REL 
to the LINK utility to produce a system 
page relocatable file that the loader 
program can use: 


A>LINK XBIOS [OS] <CR> 


where the ‘‘ [OS ] ’’ option switch tells 
LINK to output an SPR file. When 
LINK finishes there will be a file 
XBIOS.SPR on the disk. It is instruc- 
tive to load this file under DDT and 
examine it. You will find the code size, 
the object code and the bit map as de- 
scribed above and in Figure 3. 


Relocating BIOS extension loader 
program 

This is the program XLOAD refer- 
red to above. A listing for it is also 
shown. It has an absolute origin of 
0100H and runs from a COM file. It can 
be assembled with either the ASM or 
MAC assemblers. Or you can assemble 
it with RMAC (by removing the ORG 
0100H statement) and generate a COM 
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SHLD STACK ;AND CREATE A LOCAL STACK 
LXI SP,STACK ;FOR THE TRANSIENT PROCESS 
LDA FCB+1 ! CPI ' ! ;MAKE SURE NEW BIOS FILE NAME 
JNZ XL20 ;WAS ENTERED ON THE INPUT 
CALL MSG 
DB 'XLOAD - ** NO LOADABLE BIOS NAME GIVEN **',0 
CPM$¢EXIT: 
LHLD STACK ! SPHL 
RET 
XL20: LXI H,FCB+9 ;GET TO FCB FILE TYPE 
MVI M,'S' ! INX H ;FORCE "SPR" FILE TYPE 
MVI M,'P' ! INX H ;FOR DATA READ 
MVI M,'R' ! INX H 
MVI C,24 ;REMAINING FCB CHARACTER COUNT 
SLCLK: MVI M,O ! INX H ;CLEAR REST OF THE FCB 
DCR C ! JNZ SLCLR s;WRITE ALL ZEROES IN FCB 
LXI D,FCB ;GET TO FILE CONTROL BLOCK 
MVI C,OPEN ;TRY TO OPEN THE SPR FILE 
CALL BDOS 
ANA A ! JP SL50 ;CONTINUE IF FILE OPENED 
CALL MSG 


DB 'XLOAD - ** CAN''T OPEN BIOS SPR FILE #**',0 
JMP CPM$EXIT 


; KEAD THE SPR FILE INTO MEMORY IN PREPARATION FOR MOVING IT UP 
AND RELOCATING IT TO RUN. 


SL50: 
SL60: 


LXI H,BUF ;HL -> DMA ADDRESS 

PUSH H ;SAVE DMA ADDRESS PTR INSIDE LOOP 
XCHG ;DE = DMA ADDRESS POINTER 

MVI C,SETDMA ;SET CP/M DISK I/O ADDRESS 


CALL BDOS ;TO NEXT BUFFER SECTOR 

LXI D,FCB ;POINT TO FILE CONTROL BLOCK 
MVI C,READ ;READ FILE SEQUENTIAL 

CALL BDOS ;INTO NEXT BUFFER SECTOR SPOT 
POP H ;RE-FETCH CURRENT DMA ADDRESS 
LXI D,128 ! DAD D ;AND MAKE THE NEXT DMA ADDRESS 
ANA A ! JZ SL60 ;CONTINUE IF MORE TO READ 


THE FOLLOWING MOVES THE RELOCATABLE CODE FROM THE SPR FILE 
UP IN MEMORY JUST BELOW EITHER THE CP/M CONSOLE COMMAND 
PROCESSOR OR BELOW THE LAST SYSTEM MODIFICATION. 


REL1: 


REL2: 


RELM: 


AT THIS POINT HL POINT TO THE 
THE MOVED CODE IN MEMORY THAT ; 
COUNT FOK THE NUMBER OF BYTES OF CODE THAT MUST BE RELOCATED. 


DI ;DONT ALLOW INTERRUPTS HERE 
LDA BOOT+2 ! SUI 16H ;COMPUTE PAGE ADRS OF CCP 

MOV H,A ;H = CCP BASE PAGE ADDRESS 

LDA BDOS+2 ;GET CURRENT BDOS PAGE ADDRESS 

CMP H ;TEST AGAINST CCP BASE PAGE ADRS 

JNC REL1 ;IF SYSTEM NOT MODIFIED 

LHLD BDOS+1 ;ELSE GET CURRENT TOP OF MEMORY 

MVI L,O ;GET ON AN EVEN PAGE BOUNDARY 

XCHG ;DE THEN = LOWEST USED MEMORY 

LXI H,BUF+1 ;FETCH POINTER TO SPR FILE 

MOV C,M ;C-REG = LOW BYTE OF SPK CODE LENGTH 
INX H ! MOV B,M ;B-REG = HI BYTE OF SPR CODE LENGTH 
PUSH B ;PUT CODE LENGTH ON STACK 

INK C ! DCR C ;CHECK FOR EVEN PAGE LENGTH 

JZ REL2 ;SKIP IF ALREADY EVEN PAGE LONG 

INR B ;ELSE MAKE IT NEXT EVEN PAGE 

MOV A,D ! SUB B ;COMPUTE WHERE TO LOAD THE CODE 

MOV D,A ! MVI E,O ;AS CURRENT LOW MEM MINUS CODE LENGTH 
LXI H,BUF+256 ;GET START OF RELOCATABLE CODE 

POP B ! PUSH B ;GET REAL CODE LENGTH BACK 

PUSH D ;SAVE NEW CODE LOCATION POINTER 

MOV A,M ! STAX D ;MOVE UP RELOCATABLE CODE 

INX H ! INX D ;BYTE FOR BYTE WITHOUT 

DCX B ! MOV A,B s;ANY RELOCATION AT THIS POINT 

ORA C ! JNZ RELM ;LOOP ON SPR FILE CODE LENGTH 

POP D ;RE-FETCH PTK TO RELOCATABLE CODE 
LXI H,BUF+256 ;GET START OF BUFFER CODE BYTES 

POP B ;AND LENGTH OF RELOCATABLE CODE 

DAD B ;INDEX TO START OF BIT MAP 


RELOCATION BIT MAP, DE POINT TO 
MUST BE RELOCATED AND BC HAS A 


PUSH D ;PUT PAGE OFFSET ON STACK 
XCHG ;HL -> CODE DE -> BIT MAP PTR 
PUSH B ;PUT BYTE COUNT ON TOP OF STACK 


FETCH THE NEXT RELOCATION BIT MAP BYTE AND DO 8-BYTES OF 
RELOCATION USING THAT MAP BYTE. 
CODE IS FOUND.) 


(OR UNTIL END OF RELOCATABLE 


KELNMAP: 


MVI C,8 38 BITS PER MAP BYTE 
LDAX D ! MOV B,A ;FETCH NEXT MAP BYTE -> B-REG 
INX D ;BUMP POINTER TO MAP BYTES 
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file with 


LINK. you enter a command like: 


XLOAD expects to find the name 


of the SPR extension file on the com- 


A>XLOAD MYBIOS <CR> 


mand line that starts it. To use XLOAD 


SHIFT 


OUT AND TEST RELOCATION BITS. IF A BIT IS A ZEKO THEN 


THE CORRESPONDING BYTE DOES NOT HAVE TO BE RELOCATED TO RUN 


IF IT IS A ONE, THEN AN OFFSET FOR THE 


NEW BASE ADDRESS PAGE MUST BE ADDED TO THE BYTE. 


3 
; AT ITS NEW ADDRESS. 
; 


RELNBYT: 


NOREL: 


“ JNZ KELNBYT 


TABLE 


MOVBJ: 


NEWJMP: 


MSG 


STACK 
BUF 


DCR VU ;COUNT BITS IN MAP EYTE 

JM RELNMAP ;GET ANOTHER MAP BYTE IF NEED IT 
MOV A,B ! RAL ;FETCH CURRENT BIT PATTERN 

MOV B,A ;SHIFT OUT ANOTHER MAP BIT 

JNC NOREL ;SKIP IF BIT IS A ZERO 

INX SP ! INX SP ;OFFSET IS 2ND ON THE STACK 


POP PSW ;FETCH PAGE OFFS 

PUSH PSW ;AND RE-SAVE I 

DCX SP ! DCX SP ;READJUST THE STACK POINTER 
ADD M ! MOV MA ;ADD OFFSET TO MEMORY BYTE 


INX H ;NEXT MEMORY LOCATION 

XTHL ;GET BYTE COUNT (TOP OF STACK) 
DCX H ;COUNT BYTE RELOCATED 

MOV A,H ! ORA L ;SEE IF DONE 

XTHL ;PUT BACK COUNT / GET MEMORY PTR 


;CONTINUE IF MORE TO DO 


NOW WE GO AHEAD AND SAVE THE CONTENTS OF THE ORIGINAL BIOS JUMP 


FOR KEFERENCE INSIDE THE NEW BIOS MODULE. THEN WE MODIFY 


THE ORIGINAL BIOS JUMP TABLE SO IT GOES TO THE CORRESPONDING 
POINTS IN THE JUMP TABLE AT THE BEGINNING OF THE NEW MODULE. 


POP B ;DROP COUNTER FROM THE STACK 

POP H ;MAKE HL = NEW BIOS MODULE ADRS 
PUSH H ;AND SAVE ADDRESS BACK 

LXI B,0033H ! DAD B ;GET TO PLACE TO SAVE OLD JMP TABLE 
LDA BOOT+2 ;FETCH BIOS BASE PAGE ADDRESS 
MOV D,A ! MVI E,O ;THEN GET BIOS JMP TABLE POINTER 
LDAX D ! MOV M,A ;MOVE THE ORIGINAL BIOS JMP TABLE 
INX H ! INX D ;INTO THE NEW BIOS EXTENSION 

DCR C ! JNZ MOVBJ ;TO SAVE ORIGINAL ENTRY POINTS 
POP D ! PUSH D ;NOW DE = NEW BIOS MODULE 

MVI E,3 ;PLUS THREE 

LHLD BOOT+1 ;HL = NORMAL BIOS + 3 ADDRESS 
MVI C,16 ;NUMBER OF BIOS JUMPS TO FIX 

INX H ! MOV M,E ;REPLACE BIOS JUMPS TO GO TO 

INX H ! MOV M,D ;CORRESPONDING PLACES IN THE 

INX H ;NEW BIOS MODULE JUMP TABLE 

INX D ! INX D ! INX D ;MAKE NEXT JUMP ENTRY ADDRESS 
DCk C ! JNZ NEWJMP ;COUNT MODIFICATIONS AND LOOP 
POP D ! PUSH D ;RE-FETCH ADDRESS OF NEW BIOS 
LHLD BDOS+1 ;REMEMBER OLD BDOS JUMP POINT 
PUSH H ;PUT IT ON TOP OF THE STACK 

LXI H,BDOS+1 ;GET TO LOW CORE BDOS JUMP 

MOV M,E ! INX H ;AND MAKE IT GO TO OUR 

MOV M,D ;NEW BIOS MODULE 

POP B ;GET OLD BDOS ENTRY ADDRESS 

POP H 

INX H ! MOV M,C ;PUT OLD BDOS ADDRESS INTO 

INX H ! MOV M,B ;THE NEW MODULE CONTINUE JUMP 

EI ;RE-ENABLE INTERRUPTS 

RST O ;DO CP/M WARM BOOT 


SEND AN IN-LINE CODED ASCII TEXT MESSAGE TO THE CONSOLE. 
THE TEXT CHARACTERS ARE TERMINATED WITH A NULL BYTE. 


FOR EXAMPLE: 


CALL MSG 

DB 'THIS IS THE MESSAGE',0O 

EQU ¢ 

POP H ;GET NEXT CHARACTER ADDRESS 
MOV A,M ! INX H ;FETCH CHARACTER AND NEXT 
PUSH H ;SAVE POSSIBLE RETURN ADDRESS 
ANA A ! RZ ;KETURN AFTER ZERO BYTE 

MOV E,A ;ELSE CHARACTER -> E-KEG 

MVI C,CONOUT ;GET CONSOLE OUT FUNCTION CODE 
CALL BDOS ;AND SEND THE CHARACTER 

JMP MSG ; CONTINUE 

DS 64 j;ALLOCATE A 64-BYTE STACK 

DS 2 ;MAKE PLACE TO SAVE OLD <SP> 
EQU $ ;READ SPR FILE INTO HERE 
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It automatically supplies the file 
type ““SPR”’ if you do not. If XLOAD 
can’t find any file at all, or can’t open 
the one you specify, it exits with an 
error message. 

If the file is successfully opened, it 
is read into memory, moved up to the 
highest possible address in the TPA and 
relocated to run there. Once the new 
code is in place, the BIOS tables are 
adjusted and the location 0005H jump 
and the jump at the start of the new 
BIOS module are set for the new 
system. 

When XLOAD has loaded an ex- 
tension module, it exits via a warm 
boot, so you will see the warm boot 
message if all went well. 


Some other thoughts 

What happens if you have a BIOS 
extension at the top of the TPA and then 
load another extension? With the loader 
program shown the second extension 
will be loaded just below the first exten- 
sion and its handlers will be used for the 
BIOS operations. You can try this by 
loading the same extension twice (or 
three or four times). Only the handler 
routines in the new extension will be 
recognized. 

The loader program determines if it 
is running in a virgin CP/M system 
where the location 0005H jump goes 
right to the BDOS. If something is 
already in place below the CCP, the 
loader puts the BIOS extension im- 
mediately below that. If you try to use 
the BIOS modules described here along 
with some other CP/M extension (like a 
shell or whatever) they may or may not 
work correctly; so beware. 

This whole scheme of code running 
at the top of the TPA can have other 
uses. For example, you can put an in- 
terrupt driven process there instead of a 
BIOS extension. It can run concurrent- 
ly with other CP/M programs. 

Since the BDOS entry at 0005H 
now goes to the base of your loaded 
module, it has access to all BDOS calls 
from CP/M programs. If you provide 
the necessary linkage into your module 
and then on to the BDOS, you can trap 
and modify the actions of the BDOS for 
special applications. 


Summary 

This article has described a way that 
you can modify the operation of one or 
more of the BIOS handlers in a CP/M 
system without changing the BIOS it- 
self. A loader program is given that 
allows you to install these ‘‘loadable 
drivers’’ and hook them into the BIOS. 
You can have any number of BIOS 
routines for special applications and 
load and run them as they are needed. 
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The UNIX File 


by lan F. Darwin 


The UNIX File looks at many 
aspects of the UNIX operating system. 
If you have comments or questions ab- 
out UNIX or this column, feel free to 
write to lan Darwin at Box 603, Station 
F, Toronto, Ontario, Canada M4Y 
2L8. 

If you have UNIX mail access to the 
UUCP network, you can contact me at 
“ihnp4!darwinlian’’. I can’t always 
answer immediately, but I will get back 
to you (electronic mail gets answered 
first!), And I'm always glad to hear 
from readers with comments either on 
the column itself or on their reactions to 
particular UNIX systems or products. 


It’s good to be ‘‘back’. Regular 
readers of Microsystems magazine will 
recall this column’s previous incarna- 
tion there. For new readers, I'll just say 
that I try to offer an eclectic mix of 
useful information on and about UNIX 
and happenings in the known UNIX- 
verse. As I said in the very first UNIX 
File, and it’s still true two years later, 
UNIX is being seen, spoken about and 
advertised today by people who don’t 
know that much about it. The UNIX 
File is a new column that will focus on 
selected aspects of UNIX. 

My aim is to dispell myths, provide 
useful information, spotlight new pro- 
ducts (or interesting older ones), and 
occasionally steer people clear of 
lemons. In this issue I describe the Dal- 
las conference, look at the new Bell 
Labs Technical Journal on UNIX, dis- 
cuss IBM mainframe UNIX, and con- 
clude with some short notes. 


Dallas in January 

The Crystal Palace transplanted to 
Texas? Companies giving away UNIX 
systems? Reading USENET news 
bounced off a satellite? An inter-hotel 
shuttle bus system that worked? You 
could have seen all these improbabili- 
ties by joining the annual UNIX gather- 
ing of the clans in Dallas in January, 
1985. 

The Crystal Palace, built in London 
in the last century for the first World’s 
Fair, had an architecture far ahead of its 
time and has been copied in several 
parts of the world. Among the more 
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ambitious copies is the Dallas In- 
fomart, a permanent display for many 
computer companies and a large exhibit 
hall for shows such as UniForum. The 
January ‘85 /usr/group trade show was 
also the first show in the new Infomart, 
and UniForum or USENIX attendees 
could attend the grand opening. The 
new center offered plentiful space for 
the large gathering of UNIX vendors. A 
list of who was there would fill my 
entire column, so ‘nuff said. If they sell 
in the UNIX market, they were prob- 
ably there. 

And yes, there were at least two 
companies giving away UNIX boxes. I 
didn’t win either of the two new HP 
UNIX portables nor the two GOULD 
workstations, but four people now have 
UNIX on their desk as a result of enter- 
ing these draws. 

The two winners of the HP portable 
can have UNIX in the field too! Not a 
lap computer but a full-scale portable 
UNIbox, the HP has a dot-addressible 
screen usable either as a conventional 
terminal or as a window system with a 
mouse. UNIX wins over many 8-bit 
window systems, since it’s a true multi- 
programming system and you can have 
several processes each writing to its 
window concurrently. And the HP sys- 
tem includes a full UNIX system, with 
the kernel cleverly in PROM. Of course 
it is copied into RAM when it boots up, 
so that it can be patched (or custo- 
mized). At under $5K US, it’s afford- 
able for the executive wanting a port- 
able floppy-based UNIX with an 
optional hard disk that stays at the 
office. I wish I’d won one! 

Hardworking Lauren Weinstein 
was there, despite some last-minute un- 
certainties, demonstrating an ex- 
perimental method of distributing 
USENET news — via satellite. The 
experimental (so far!) link uses the 
video retrace interval on a domestic 
television satellite to transmit news, in 
a fashion similar to closed-caption 
coverage or stock-market services or 
Telidon/NAPLPS service. Many hur- 
dles remain before it could be used to 
cut down on production USENET’s 
phone bills, but the demonstration went 
smoothly and as planned. Kudos to 


Lauren for making it happen, and to the 
USENIX association for backing the 
project. 

And there were two full days of 
technical talks on UNIX. Conference 
co-host Rob Kolstad gave an amusing 
keynote talk on ‘gurus’. A wide range 
of topics was covered, and your col- 
umnist gave a talk on UNIX Program- 
ming Style. Proceedings are $20 (plus 
$15 for overseas airmail) from USE- 
NIX (see below). Kolstad and co-host 
Charisse Castagnoli as well as the prog- 
ram committee deserve a round of ap- 
plause for organising an above-average 
technical program. And for organising 
evening trips, including the one to play 
Photon. .. The Fairmont Hotel was not 
inexpensive, but well situated and 
functional — even a twenty-four-hour 
coffee shop! 

This marked the last ‘‘joint /usr/ 
group-USENIX conference’’ for a 
while. Summer’s USENIX technical 
conference is slated for Portland, Ore- 
gon in June 11-14, 1985, and will have 
both technical sessions and a trade 
show. Next winter’s USENIX and Uni- 
Forum will be held in different cities a 
month or so apart. It was fun for atten- 
dees while it lasted, but I guess the 
associations involved had too many dif- 
fering priorities. They also had the 
problem of finding conference facilities 
big enough to hold both shows at the 
same time. 

For information on upcoming USE- 
NIX conferences, write Box 7, El Cer- 
rito CA 94530, or phone 415-528- 
8649, or mail ucbvax!usenix!office. 
Details on the 1986 UniForum can be 
had from /usr/group, 4655 Old Iron- 
sides Drive, Suite 200, Santa Clara CA 
95050. 

Other upcoming conferences in- 
clude the European UNIX User Group 
(April in Paris), C/85, billed as the 
‘First National Conference on C’ (San 
Francisco, May 13-85, contact C/85 
c/o Lifeboat, 1651 Third Ave, N Y, 
NY 10128), and UNIX EXPO, a trade 
show, in New York, September 18-20, 
1985 (contact National Expositions, 14 
W 40th St, New York NY 10018, 212- 
391-9111). 
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Let’s Get Technical... 

Wanna get technical? Apart from 
wading through the source code, a main 
source of UNIX information has been 
the BSTJ issue on UNIX. As I wrote in 
the November issue of Microsystems, 
“*After the manuals, another important 
series of papers... appeared in the Bell 
System Technical Journal, July-August 
1978. This special issue [is] part 2 of 
the July-August 1978 issue... The 
magazine is now called Bell Laborator- 
ies Technical Journal and is doing 
another special issue on UNIX that 
should come into print around the same 
time as this article. Watch for it!”’ 


That issue came into print as and 
when predicted, and is now being dis- 
tributed. The list of contributors reads 
like a who’s who of current UNIX re- 
search and development inside AT&T 
and Bell Labs. The table of contents 
(see box) provides an idea of the 
breadth of topics covered. If you’re in- 
terested in the technical side of UNIX 
— what’s inside, new user and system 
interfaces, history, etc. — get a copy. 
But it’s not cheap — the price is 
$27.50, and it has more typographical 
errors than you’d hope for. Order from 
ATT Customer Information Centre, 
Box 19901, Indianapolis IN 46219. 


Table of Contents — Bell Labs Technical Journal, October 1984 


Preface: R. L. Martin 
Foreword: A. V. Aho 


The Evolution of the UNIX Time-sharing System: D. M. Ritchie 

Program Design in the UNIX System Environment: R. Pike, B. W. Kernighan 
The Blit — A Multiplexed Graphics Terminal: R. Pike 

Debugging C Programs With the Blit: T. Cargill 

UNIX Operating System Security: F. T. Grampp, R. H. Morris 

File Security and the UNIX System Crypt Command: J. A. Reeds, P. J. Weinberger 


The Evolution of C: L. Rosler 
Data Abstraction in C: B. Stroustrup 


Multiprocessor UNIX Systems: S. J. Buroff, M. J. Bach 
A UNIX System Implementation for System/370: W. A. Felton, G. L. Miller, 


J.M. Milner 


UNIX Operating System Porting Experiences: D. E. Bodenstab, et. al. 

The Evolution of UNIX System Performance: J. Feder 

Cheap Dynamic Instruction Counting: P. J. Weinberger 

Theory and Practice in the Construction of a Working Sort Routine: J. P. Linderman 


The Fair Share Scheduler: G. J. Henry 


The Virtual Protocol Machine: M. J. Fitton, C. J. Harkness, et. al. 
A Network of Computers Running the UNIX System: T. E. Fritz, J. E. Hefner, 


T.M. Raleigh 


A Stream Input/Output System: D. M. Ritchie 


UNIX Goes Virtual 

In February, 1985 IBM announced 
a System V port of UNIX for its main- 
frame computer family. This put to rest 
the silly and unfounded rumors that 
IBM was trying to drive a wedge be- 
tween System HII and ATT’s newer 
‘Consider it Standard’’ System V. (If 
they’d been in a wedgy mood, they 
could have gone with 4.2BSD). The 
big blue behemoth probably went with 
System III for its smaller PC line be- 
cause a System III for the 8086 was 
conveniently available when they 
needed it. Look for the PC port to be 
upgraded to System V sometime soon. 
Details on the IBM mainframe port *IX/ 
370° would at least fill this column, but 
here’s a brief summary. This UNIX 
runs as a timesharing system under 
VM/SP on supported IBM mainframes, 
offers full System V with uucp and vi 
and full-duplex ASCII terminal support 
(via channel-attached Series/1 front 
end), no 3270-series support, its own 
screen editor, and is otherwise a full 
and ‘standard’ System V port. Excep- 
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tions: no games (this is IBM, after all), 
and no on-line documents (does this 
mean no man command? I think not, 
but you never know. ..). 

Giving big blue a run for its money 
is Amdahl. They announced their Sys- 
tem V port for IBM (and Amdahl) 
mainframes at UniForum, a few weeks 
before IBM. Amdahl has had a primi- 
tive UNIX port out for several years; 
their new product, also a ‘Standard 
System V’, needs an Amdahl 4705 
front end but supports both full-duplex 
ASCII and IBM 3270 terminals. These 
are the third and second public IBM 
ports; the first is from ATT but is not 
widely available outside the labs. See 
the BLTJ issue mentioned above for a 
paper on the ATT port; contact your 
IBM and Amdahl rep for details on 
their products. 

What do these two ports mean? 
Mainframe UNIX is more widely avail- 
able than ever. And with the support of 
two megacorporations, both of them 
pushing ATT’s System V standardiza- 
tion effort, UNIX runs on more compu- 


ters from micros to mainframes. The 
effects on UNIX direction and evolu- 
tion of having IBM among the main 
players, however, may not be what 
UNIX old-timers had in mind. Only 
time will tell. 


Miscellany 

More UNIX Publications: First is 
The Business UNIX Journal, whose in- 
troduction says: ‘*. . . tens of thousands 
of Unix, Xenix and compatible systems 
are already in place and hard at work 
providing business and office automa- 
tion functions. Many more systems are 
bound to be added to that figure. Our 
charter... is to provide a communica- 
tion forum and an information service 
to the users and the vendors of these 
systems.’’ Write them at Box 1065, 
Lafayette, CA 94549. Phone 415-284- 
1610. The price is $28/year for six 
issues. And not one two journals on the 
C language. The C Journal is from 
InfoPro, at 3108 Route 10, Box 849, 
Denville NJ 07834, phone 201-989- 
0570, UNIX mail harpo!infopro!cj. It 
is ‘‘aimed at the technical people 
directly involved in using C and at 
[their] managers...’ Cost is $28/ 
year (4 issues), plus $9 for overseas 
airmail. And /C from Cue Publications, 
7999 Knue Road, Indianapolis IN 
46250, phone 800-227-7999 or 317- 
842-7162. Price is $60/year for 12 
issues. And software coming over the 
phone... AT&T is pioneering a new 
method of selling software. You not 
only order by phone, but they deliver it 
by phone (after all, this is the phone 
company, right?). You order by dialing 
into a menu system, and the software is 
delivered by uucp. Called the *‘Soft- 
ware Toolchest’’, it is filled with soft- 
ware that is usable but for one reason or 
another did not become formal pro- 
ducts. Prices I saw ranged from $40 
(the source to a video game) to several 
thousands of dollars for ksh , a UNIX 
shell interpreter that has been much dis- 
cussed of late. Also listed were editors, 
languages, debuggers, etc. All this 
software is tested, but not supported; 
the database tells you what machines 
and systems it has run on. The Tool- 
chest is being opened up in stages; you 
must have a System V source license to 
use the Software Toolchest during 
phase one. Phase two, slated for later in 
*85, will make it available to anybody 
with an interest in UNIX software. The 
data phone number is 201-522-6900, 
login as ‘guest’, voice phone is 201- 
522-6698 (answered 9-5 EST). 

That's all for this month. Cards and 
letters and electronic mail welcome on 
these and other topics, especially sug- 
gestions for future columns. Cheers! 
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by Bruce R. Ratoff 


The Public Domain Hit Parade 

One need only work with CP/M for 
arelatively short while to know that it is 
a solid, reliable system in most re- 
spects. One of its unfortunate short- 
comings, however, is that only the 
most rudimentary of software tools are 
provided with the standard system. 
Most CP/M programmers soon begin to 
accumulate additional utility programs, 
creating their own ‘“‘bag of tricks”’ from 
which they can draw to make their work 
easier. Luckily for all of us, many top- 
notch programmers have generously 
decided to share the tools they have 
created with the rest of us, by placing 
them into one of the public-domain 
software libraries, such as SIG/M. 
Some of these programs have become 
so popular that many of us would feel 
lost without them. Some programs 
seem to actually develop a life of their 
own. While the original authors watch 
with a sometimes Frankensteinian awe, 
version after version, containing dif- 
ferent programmers’ improvements, 
continue to appear in the public domain 
libraries and Remote CP/M bulletin 
boards across the U.S. We can hope 
that the original author will view this 
phenomenon as a compliment to his/her 
efforts, and continue to place other use- 
ful tools in the public domain. 

What sort of tools are we talking 
about? Well, although everyone has 
their own preference, based on their 
own tastes and work habits, I thought it 
might be useful to talk about some of 
the public-domain programs that I 
wouldn’t want to be caught without. 
This is by no means an exhaustive list. 
It was derived simply by skimming 
through the directories of a few of my 
working disks. This listing therefore 
reflects those programs which I find 
useful in my own day-to-day pro- 
gramming activities. 


Compare 

This simple little utility compares 
one binary file with another, byte by 
byte, and displays the differences in 
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hex. It is useful for deciding whether 
two .COM files with the same name are 
really the same file. More importantly, 
you can discover if the differences are 
minor (a last minute patch, for exam- 
ple) or major. You won’t trot this one 
out every day, but there are times when 
nothing else will do. 


CRC and CRCK 

Two different variations on the 
same basic idea: compute a unique, 16- 
bit ‘‘magic number’’ from the arbitrary 
contents of a file. The technique used in 
computing a “‘CRC’’ (Cyclic Redun- 
dancy Check) value treats the file as a 
bit stream, making it resistant to being 
fooled by bit position, byte position or 
special values. Both programs handle 
wildcards, and will optionally generate 
a file containing all the filenames and 
their CRC values. In addition, 
CRC.COM will later read a file con- 
taining filenames and CRC’s, re- 
compute the CRC’s of all files, and 
report any differences. 

There are many uses for this pro- 
gram. It will quickly tell you if two files 
are identical, by whether they have the 
same CRC value (admittedly, there is 
one chance in 65536 of being wrong!). 
It is similarly useful after modeming a 
file to someone else, as a final check 
that the file arrived intact. If you 
periodically generate a CRC list for all 
the files on a disk, you may then use 
CRC later on to see what files have 
been changed. Finally, when making 
backups of a set of files from hard disk 
to floppy, I put a CRC list on the floppy 
as an extra means of checking my 
backup copies. I’m sure you'll come up 
with additional uses for this program. 


DIF2 and SSED2 

DIF2 does a line-by-line ASCII 
compare of two files. Its intended use is 
to list all the changes between two 
different versions of a program in 
source code form. This program is writ- 
ten in the C language, and is actually an 
adaptation of a UNIX system utility, 
but it will work on source programs in 
just about any language. UNIX-style 
input and output redirection is sup- 
ported, so you can generate a file of all 
the differences. There is also an option 
to output the differences in the form of a 
series of editing commands. The result- 
ing file of edit commands, when fed 
into the SSED2 program along with one 
version of the program, will produce 
the other version of the program. This 
“‘difference file’’ technique provides a 
compact way of distributing source 
code updates. It is frequently used on 
the bulletin boards to avoid having to 
download an entire source file just to 
pick up a few minor changes. 


DU 

If I had to pick one program that I 
wouldn’t want to be without, this is it. 
DU stands for ‘‘Disk Utility’’, and 
what it allows you to do is perform 
“‘brain surgery’? on your CP/M disks. 
Using DU, you can easily examine and 
modify any byte on a disk. You can 
search for a particular string of bytes 
anywhere on the disk, position any- 
where on the disk by track and sector or 
by CP/M block number, copy sectors 
from one place to another and fill sec- 
tors with a particular value. You can 
also get a usage map of a disk, showing 
what CP/M blocks belong to which 
files. There is a simple command mac- 
ro facility to make repetitive jobs a bit 
easier. If you know the internal layout 
of a CP/M directory, you can use this 
program to unerase files, reconstruct 
lost backups, etc. I also use it occa- 
sionally to make simple patches (it’s a 
whole lot quicker when your changes 
are small). 


FIND 

This program will search through a 
file or group of files (it takes the normal 
* and ? wildcards) and display all lines 
containing a particular string. I find it 
very useful while working on a large 
program to find all the references to a 
particular label or variable. Unlike the 
search command in most editors, FIND 
will locate all occurrences of the string 
in both upper and lower case with a 
single command. Not having to use an 
editor to perform this function has 
saved me hours and hours. 


LU 

LU stands for ‘‘Library Utility’’, 
and what it allows you to do is to take a 
bunch of related files or programs and 
stick them together into one much lar- 
ger file. What you are then left with is a 
single file that can be copied or 
modemed around, and later broken 
back into separate files again using LU. 
This is a popular utility on the bulletin 
boards for ‘‘packaging’’ all the files 
associated with a program. If you have 
a lot of small files, it can also be a space 
saver, since space in the library file is 
allocated in individual sectors rather 
than CP/M blocks. LU itself contains 
commands for adding files to a library, 
extracting them, deleting them, taking 
a directory of the library, and reorga- 
nizing a library to reclaim wasted space 
from deleted files. There are additional 
separate utilities for displaying, 
modeming and running files from a lib- 
rary without extracting them first. 


(continued on page 77) 


75 


LIFE IN THE FAST LANE! 


Experience NightOwl Software’s cornucopia of ultra high- 
speed communications packages, featuring US Robotics’ 
Courier 2400 modem, the NightOwl Connection and MEX- 
PC — the Cadillac of communications software. 


Consider the elements: 


@ U.S. ROBOTICS COURIER 2400, the state-of-the-art auto dial/auto answer 
modem. Features: 300/1200/2400-baud operation; nine front-panel LEDs; 
line-busy detect; built-in help screens; status screen; volume-controlled 
speaker; full Hayes-type “AT command set; a typeset 80-page User's Manual. 
List price $699.95... secetetevetseetereneeene OUP price: $599.95 


@ NIGHTOWL CONNECTION, our multi-user software database. The Con- 
nection, with 2400-baud Couriers on all incoming lines, features an IBM area 
with 5 MB of public domain offerings, a Turbo-Pascal area, Kaypro- and Os- 
borne-specific areas, plus directories crammed with compiler, language, word 
processing and communications programs for CP/M-80, CPM+ and Turbo- 
DOS — not to mention the most complete collection of MEX overlays and 
automated command files available anywhere. Allows full contact with other 
users and fast, personalized access to our technical support staff 

Our price: $100 


@ MEX-PC, the most flexible communications package available for the IBM- 
PC, puts more power at your fingertips than you ever dreamed possible. If 
you're struggling along with PC-TALK or Crosstalk XVI, experience the power 
of MEX-PC! Three protocols: Christensen XMODEM (CRC, Checksum & 
MODENM-7 “‘batch-file” protocols), CompuServe A protocol, XON/XOFF @ - 
Multiple phone libraries @ KEY editor for defining not only on IBM’s func- 
tion keys, but anyalpha-numeric key on the IBM keyboard @ Automatic list- 
dialing/redialing @ Script file processor allows you to generate fully auto- 
mated log-ons, log-offs, uploads & downloads — even conditionals @ SHELL 
command lets you run any program or DOS command from within MEX with- 
out loss of text stored in memory. (Run your spreadsheet or word processor 
from within your communications program!) @ Built-in HELP facility docu- 
ments the entire program @ 180-page User’s Guide — ring-bound, typeset, 
fully-indexed, with complete tutorial... ....Our price $59.95 


Save even more with our packages: 


Triple Play: Courier 2400 modem, MEX-PC and an A-class 
subscription to the NightOwl Connection (an $860 value) .... 
waehp pov dvatanhane edi tase tesa ahcacagurseaelalastaasatstatatercateciiches $689.95 


Two Bagger: Courier 2400 and an A-class subscription to the 
NightOwl Connection (an $800 value) ........ccccceee $639.95 


Ground Rule Double: Courier 2400 and MEX-PC (a $760 
(0 <) re esthetic $609.95 
Call or write for information about other specials from NightOwl 
Software for CP/M, CP/M+ and TurboDOS operating systems. 
Formats: 8” (SS,SD) format, and most 54” formats (except Apple and NorthStar). Please 


specify disk format when ordering, 


To order by credit card, call us toll-free at 1-800-NITEOWL. In Wis- 
consin, call 1-414-563-4013. To order by mail, send certified check, 
cashier’s check or money order to: 


ae) NightOwl Software, Inc. 
VISA Route 1 Box 7 
aaa Fort Atkinson, WI 53538 


Personal checks accepted, but will delay shipment 14 days. 


Prices do not include shipping. All items shipped UPS ground unless otherwise specified 
For modems and modem packages, add $10; for software add $5. For UPS two-day air de- 
livery (formerly UPS Blue) add $16 for modem packages or $13 for software products 
Canadian orders add an extra $7.50 to shipping costs. Wisconsin residents add 5 percent 
sales tax 


Micro/Systems Journal Back Issues 
The first issue of Micro/Systems 


Journal is still available. Send $4 per 
copy ($5.50 foreign, cash or U.S. Bank 
check) including shipping. 


Microsystems Back Issues 


The following back issues of the old Microsystems 
magazine are still available. Quantities of many of the 
issues are, however, limited. They are $3.50 per copy 
($5.00 foreign, cash or U.S. bank check) including 
shipping. If ordering 3-9 copies deduct 10%, 10 or more 
copies deduct 15%. Make check out to “‘Micro/Systems 
Journal’’, Box 1192, Mountainside NJ 07092. 


1984 


NOVEMBER: Unix Development; MS-DOS Prompt 
Command Features; X.25 Communications Protocol - Part 
3; How Portable is C?; S-100 Power Switching and dealing 
with slow Eproms; Unix MAKE utility and a shell 
“*exec’’; Bulletin Boards for the PC; REVIEWS: PFIX-86, 
Codata 3300, HALO. 


AUGUST: Intro to Local Area Networking; Graphics 
Subroutines in C For NAPLPS; Using YACC, MAKE and 
Prolog under Unix; Multiprocessing on S-100; Using Unix 
Sort, ciphers and enhancements; REVIEWS: TurboDOS, 
NCR-PC, MindSet-PC, Adding TurboDOS to NorthStar 
System, Leverage DBMS for Unix. 


JULY: Intro to Computer Graphics; Intro to NAPLPS; 
NAPLPS Directory; Graphics on DEC PRO/350, NCR-PC 
and Mindset; Speed up S-100 front panels; Unix 
Portability, REVIEWS: DRI-GSX, Princeton Graphics 
HX-12, Quickpel, Createx, Videophile, DRI-PL/1-86, 
Mitsubishi half-height 8’’ drives. 

JUNE: Implement X.25 Communications Protocol, RCPM 
and RPC Systems; RCPM Directory; 
Computer-to-Computer File Transfers; Log onto your 
system as a Remote Terminal; 8250 UART Interfacing; 
S-100 Interrupts, clock signals, RTC and power 
requirments; REVIEWS: ASCOM, 212A modems. 


APRIL: Unix Software Directory; Upgrade NorthStar 
ZPB; MS-DOS 2.0 Overview - Part 2; S-100 Phantom & 
Bank Selecting; Upgrading FIG Forth; REVIEWS: 
UniPlus + , Informix, DRI-C. 


FEBRUARY: Using WordStar to Create 
Mailmerge/DBase-II files; Moving data files between 
CP/M software packages; Datestamp DBase-I]; CP/M 2.2 
Deblocking; Building S-100 diagnostic hardware; Enhance 
CP/M+ with RSX; REVIEWS: DBase-II, S-100 
Mainframes, DRI Display Manager, AutoDex, Turbo 
Pascal. 


JANUARY: Enhancing MP/M - Part 1; Installing MP/M; 
Add Concurrency to MP/M; Two Users on CP/M; 
Relocating Assemblers & Linkage Editors - Part 3; S-100 
Wait States; REVIEWS: MP/M-8/16, ProComp-8, 
Paragraphics Game Board, ProLog. 


1983 


DECEMBER: CP/M Software Directory; A Debug 
Subroutine; Implement IOBYTE on North Star; Floppy 
Disk Problems; Improve Trig Functions in CBasic-80; 
Build Cheap S-100 Memory; Extended Memory 
Management; CP/M-86 BDOS Calls; REVIEWS: XLISP, 
LISP/80, TLC LISP, APC Basic, Microdynamics S-100 
EProm Programmer, Ackerman S-100 Digital Synthetalker, 
Digital Research 16K & 32K S-100 Memory cards. 


